--- external help file: PSScriptTools-help.xml Module Name: PSScriptTools online version: http://bit.ly/31RGrOE schema: 2.0.0 --- # ConvertTo-UTCTime ## SYNOPSIS Convert a local datetime to universal time. ## SYNTAX ```yaml ConvertTo-UTCTime [[-DateTime] ] [-AsString] [] ``` ## DESCRIPTION Convert a local datetime to universal time. The default is now but you can specify a datetime value. You also have an option to format the result as a sortable string. This command was introduced in v2.3.0. ## EXAMPLES ### Example 1 ```powershell PS C:\> Get-Date Monday, December 28, 2020 7:43:13 PM PS C:\> ConvertTo-UTCTime Tuesday, December 29, 2020 12:43:37 AM ``` ### Example 2 ```powershell PS C:\> ConvertTo-UTCTime -asString 2020-12-29 00:44:01Z ``` ## PARAMETERS ### -DateTime Enter a Datetime value ```yaml Type: DateTime Parameter Sets: (All) Aliases: Required: False Position: 0 Default value: now Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` ### -AsString Convert the date-time value to a sortable string. This is the same thing as running a command like "{0:u}" -f (Get-Date).ToUniversaltime() ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS ### System.DateTime ## OUTPUTS ### System.DateTime ## NOTES Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/ ## RELATED LINKS [ConvertFrom-UTCTime]() [Get-Date]()