ConvertTo-UTCTime.md

external help file	Module Name	online version	schema
PSScriptTools-help.xml	PSScriptTools	http://bit.ly/31RGrOE	2.0.0

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, March 4, 2019 12:51:47 PM


PS C:\> ConvertTo-UTCTime

Monday, March 4, 2019 5:51:49 PM

Example 2

PS C:\> ConvertTo-UTCTime -asString
2019-03-04 17:51:47Z

PARAMETERS

-DateTime

Enter a Datetime value

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()

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.

INPUTS

System.DateTime

OUTPUTS

System.DateTime

NOTES

Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/

RELATED LINKS

ConvertFrom-UTCTime

Get-Date