ConvertTo-UTCTime
SYNOPSIS
Convert a local datetime to universal time.
SYNTAX
ConvertTo-UTCTime [[-DateTime] <DateTime>] [-AsString] [<CommonParameters>]
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
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
PS C:\> ConvertTo-UTCTime -asString
2020-12-29 00:44:01Z
PARAMETERS
-DateTime
Enter a Datetime value
Type: System.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()
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
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.
INPUTS
System.DateTime
OUTPUTS
System.DateTime
NOTES
Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/