Get-Date

参考

模块:: Microsoft.PowerShell.Utility

获取当前日期和时间。

语法

Get-Date
   [[-Date] <DateTime>]
   [-Year <Int32>]
   [-Month <Int32>]
   [-Day <Int32>]
   [-Hour <Int32>]
   [-Minute <Int32>]
   [-Second <Int32>]
   [-Millisecond <Int32>]
   [-DisplayHint <DisplayHintType>]
   [-Format <String>]
   [-AsUTC]
   [<CommonParameters>]

Get-Date
   [[-Date] <DateTime>]
   [-Year <Int32>]
   [-Month <Int32>]
   [-Day <Int32>]
   [-Hour <Int32>]
   [-Minute <Int32>]
   [-Second <Int32>]
   [-Millisecond <Int32>]
   [-DisplayHint <DisplayHintType>]
   -UFormat <String>
   [<CommonParameters>]

Get-Date
   -UnixTimeSeconds <Int64>
   [-Year <Int32>]
   [-Month <Int32>]
   [-Day <Int32>]
   [-Hour <Int32>]
   [-Minute <Int32>]
   [-Second <Int32>]
   [-Millisecond <Int32>]
   [-DisplayHint <DisplayHintType>]
   [-Format <String>]
   [-AsUTC]
   [<CommonParameters>]

Get-Date
   -UnixTimeSeconds <Int64>
   [-Year <Int32>]
   [-Month <Int32>]
   [-Day <Int32>]
   [-Hour <Int32>]
   [-Minute <Int32>]
   [-Second <Int32>]
   [-Millisecond <Int32>]
   [-DisplayHint <DisplayHintType>]
   -UFormat <String>
   [<CommonParameters>]

说明

cmdlet Get-Date 获取一个 DateTime 对象，该对象表示当前日期或指定的日期。 Get-Date 可以采用多种 .NET 和 UNIX 格式设置日期和时间的格式。可以使用 Get-Date 生成日期或时间字符串，然后将该字符串发送到其他 cmdlet 或程序。

Get-Date 使用计算机的区域性设置来确定输出的格式设置方式。若要查看计算机的设置，请使用 (Get-Culture).DateTimeFormat。

示例

示例 1：获取当前日期和时间

在此示例中， Get-Date 显示当前系统日期和时间。输出格式为 long-date 和 long-time 格式。

Get-Date

Tuesday, June 25, 2019 14:53:32

示例 2：获取当前日期和时间的元素

此示例演示如何使用 Get-Date 获取日期或时间元素。参数使用日期、时间或 DateTime 参数。

Get-Date -DisplayHint Date

Tuesday, June 25, 2019

Get-Date 使用 DisplayHint 参数和 Date 参数来仅获取日期。

示例 3：使用 .NET 格式说明符获取日期和时间

在此示例中，.NET 格式说明符用于自定义输出的格式。输出是一个 String 对象。

Get-Date -Format "dddd MM/dd/yyyy HH:mm K"

Tuesday 06/25/2019 16:17 -07:00

Get-Date 使用 Format 参数指定多个格式说明符。

此示例中使用的 .NET 格式说明符定义如下：

说明符	定义
`dddd`	一周中的某一天 - 全名
`MM`	月份
`dd`	月份中的某一天 - 2 位数字
`yyyy`	4 位格式的年份
`HH:mm`	24 小时格式的时间 - 无秒
`K`	与世界时坐标 (UTC) 的时区偏移量

有关 .NET 格式说明符的详细信息，请参阅自定义日期和时间格式字符串。

示例 4：使用 UFormat 说明符获取日期和时间

在此示例中，多个 UFormat 格式说明符用于自定义输出的格式。输出是一个 String 对象。

Get-Date -UFormat "%A %m/%d/%Y %R %Z"

Tuesday 06/25/2019 16:19 -07

Get-Date 使用 UFormat 参数指定多个格式说明符。

此示例中使用的 UFormat 格式说明符定义如下：

说明符	定义
`%A`	一周中的某一天 - 全名
`%m`	月份
`%d`	月份中的某一天 - 2 位数字
`%Y`	4 位格式的年份
`%R`	24 小时格式的时间 - 无秒
`%Z`	与世界时坐标 (UTC) 的时区偏移量

有关有效 UFormat 格式说明符的列表，请参阅 Notes 部分。

示例 5：获取一年中的日期

在此示例中，属性用于获取一年中的数字日期。

公历有 365 天，但闰年有 366 天。例如，2020 年 12 月 31 日为第 366 天。

(Get-Date -Year 2020 -Month 12 -Day 31).DayOfYear

366

Get-Date 使用三个参数指定日期： Year、 Month 和 Day。命令用括号包装，以便由 DayofYear 属性计算结果。

示例 6：检查是否根据夏令时调整了日期

此示例使用布尔方法验证日期是否由夏令时调整。

$DST = Get-Date
$DST.IsDaylightSavingTime()

True

一个变量， $DST 存储的结果 Get-Date。 $DST 使用 IsDaylightSavingTime 方法测试日期是否针对夏令时进行调整。

示例 7：将当前时间转换为 UTC 时间

在此示例中，当前时间转换为 UTC 时间。系统区域设置的 UTC 偏移量用于转换时间。 “备注”部分中的表列出了有效的 UFormat 格式说明符。

Get-Date -UFormat "%A %B/%d/%Y %T %Z"
$Time = Get-Date
$Time.ToUniversalTime()

Wednesday June/26/2019 10:45:26 -07

Wednesday, June 26, 2019 17:45:26

Get-Date 使用 UFormat 参数和格式说明符来显示当前系统日期和时间。格式说明符 %Z 表示 -07 的 UTC 偏移量。

变量 $Time 存储当前系统日期和时间。 $Time 使用 ToUniversalTime () 方法根据计算机的 UTC 偏移量转换时间。

示例 8：Create时间戳

在此示例中，格式说明符为目录名称创建时间戳 String 对象。时间戳包括日期、时间和 UTC 偏移量。

$timestamp = Get-Date -Format o | ForEach-Object { $_ -replace ":", "." }
New-Item -Path C:\Test\$timestamp -Type Directory

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         6/27/2019    07:59                2019-06-27T07.59.24.4603750-07.00

变量 $timestamp 存储命令的结果 Get-Date 。 Get-Date 使用格式说明符为小写 o 的 Format 参数创建时间戳 String 对象。对象在管道 ForEach-Object中向下发送到。 ScriptBlock 包含$_代表当前管道对象的变量。时间戳字符串由用句点替换的冒号分隔。

New-Item 使用 Path 参数指定新目录的位置。路径包含 $timestamp 变量作为目录名称。 Type 参数指定创建目录。

示例 9：转换 Unix 时间戳

此示例将 Unix 时间（由 1970-01-01 0:00:00 以来的秒数表示）转换为 DateTime。

Get-Date -UnixTimeSeconds 1577836800

Wednesday, January 01, 2020 12:00:00 AM

示例 10：返回解释为 UTC 的日期值

此示例演示如何将日期值解释为其 UTC 等效值。例如，此计算机设置为 太平洋标准时间。默认情况下， Get-Date 返回该时区的值。使用 AsUTC 参数将值转换为 UTC 等效时间。

PS> Get-TimeZone

Id                         : Pacific Standard Time
DisplayName                : (UTC-08:00) Pacific Time (US & Canada)
StandardName               : Pacific Standard Time
DaylightName               : Pacific Daylight Time
BaseUtcOffset              : -08:00:00
SupportsDaylightSavingTime : True

PS> (Get-Date -Date "2020-01-01T00:00:00").Kind
Unspecified

PS> Get-Date -Date "2020-01-01T00:00:00"

Wednesday, January 1, 2020 12:00:00 AM

PS> (Get-Date -Date "2020-01-01T00:00:00" -AsUTC).Kind
Utc

PS> Get-Date -Date "2020-01-01T00:00:00" -AsUTC

Wednesday, January 1, 2020 8:00:00 AM

参数

-AsUTC

将日期值转换为 UTC 中的等效时间。

此参数是在 PowerShell 7.1 中引入的。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Date

指定日期和时间。时间是可选的，如果未指定，则返回 00：00：00。

以系统区域设置的标准格式输入日期和时间。

例如，使用美国英语：

Get-Date -Date "6/25/2019 12:30:22" 返回 2019 年 6 月 25 日，星期二 12：30：22

Type:	DateTime
Aliases:	LastWriteTime
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Day

指定显示月份中的某一天。输入一个介于 1 到 31 之间的值。

如果指定的值大于一个月内的天数，则 PowerShell 会将天数添加到月份。例如， Get-Date -Month 2 -Day 31 显示 3 月 3 日，而不是 2 月 31 日。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayHint

确定要显示日期和时间的哪些元素。

接受的值如下所示：

日期：仅显示日期
时间：仅显示时间
DateTime：显示日期和时间

Type:	DisplayHintType
Accepted values:	Date, Time, DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Format

采用格式说明符指示的 Microsoft .NET Framework 格式显示日期和时间。 Format 参数输出 String 对象。

有关可用 .NET 格式说明符的列表，请参阅自定义日期和时间格式字符串。

使用 Format 参数时， Get-Date 仅获取显示日期所需的 DateTime 对象的属性。因此，DateTime 对象的某些属性和方法可能不可用。

从 PowerShell 5.0 开始，可以使用以下附加格式作为 Format 参数的值。

FileDate。本地时间当前日期的文件或路径友好表示形式。格式 (yyyyMMdd 区分大小写，使用 4 位年份、2 位月份和 2 位日期) 。例如：20190627。
FileDateUniversal。世界时当前日期的文件或路径友好表示形式 (UTC) 。格式 (yyyyMMddZ 区分大小写，使用 4 位年份、2 位月份、2 位日期和字母 Z 作为 UTC 指示器) 。例如：20190627Z。
FileDateTime。以本地时间表示的当前日期和时间的文件或路径友好表示形式，格式为 24 小时。格式 (yyyyMMddTHHmmssffff 区分大小写，使用 4 位年份、2 位月份、2 位日期、字母 T 作为时间分隔符、2 位小时、2 位分钟、2 位秒和 4 位毫秒) 。例如：20190627T0840107271。
FileDateTimeUniversal。世界时 (UTC) 当前日期和时间的文件或路径友好表示形式，格式为 24 小时。格式 (yyyyMMddTHHmmssffffZ 区分大小写，使用 4 位年份、2 位数月份、2 位日期、字母 T 作为时间分隔符、2 位数小时、2 位数分钟、2 位数秒、4 位数毫秒，并将字母 Z 用作 utc 指示器) 。例如：20190627T1540500718Z。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Hour

指定要显示的小时。输入一个介于 0 到 23 的值。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Millisecond

指定日期中的毫秒。输入一个介于 0 到 999 的值。

此参数是在 PowerShell 3.0 中引入的。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Minute

指定要显示的分钟。输入一个介于 0 到 59 的值。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Month

指定要显示的月份。输入一个介于 1 到 12 的值。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Second

指定要显示的秒。输入一个介于 0 到 59 的值。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UFormat

采用 UNIX 格式显示日期和时间。 UFormat 参数输出字符串对象。

UFormat 说明符前面是百分号 (%) ，例如、 %m%d和 %Y。 Notes 部分包含有效的 UFormat 说明符表。

使用 UFormat 参数时， Get-Date 仅获取显示日期所需的 DateTime 对象的属性。因此，DateTime 对象的某些属性和方法可能不可用。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnixTimeSeconds

日期和时间表示自 1970 年 1 月 1 日 0：00：00 以来的秒数。

此参数是在 PowerShell 7.1 中引入的。

Type:	Int64
Aliases:	UnixTime
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Year

指定要显示的年份。输入 1 到 9999 的值。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Pipeline input

Get-Date 接受管道输入。例如 Get-ChildItem | Get-Date。

输出

System.DateTime or System.String

Get-Date 返回 DateTime 对象，但使用 Format 和 UFormat 参数时除外。 Format 或 UFormat 参数返回 String 对象。

将 DateTime 对象向下发送到需要字符串输入的 cmdlet Add-Content 时，PowerShell 会将该对象转换为 String 对象。

方法 (Get-Date).ToString() 将 DateTime 对象转换为 String 对象。

若要显示对象的属性和方法，请将对象向下发送到管道 Get-Member。例如 Get-Date | Get-Member。

备注

对于系统区域设置，DateTime 对象采用长日期和长时间格式。

下表中显示了有效的 UFormat 说明符 ：

格式说明符	含义	示例
`%A`	一周中的某一天 - 全名	星期一
`%a`	一周中的某一天 - 缩写名称	Mon
`%B`	月份名称 - 完整	1 月
`%b`	月份名称 - 缩写	一月
`%C`	世纪	2019 年为 20
`%c`	日期和时间 - 缩写	周四六月 27 08：44：18 2019
`%D`	采用 mm/dd/yy 格式的日期	06/27/19
`%d`	月份中的某一天 - 2 位数字	05
`%e`	月份中的某一天 - 如果只有一个数字，则前面有一个空格	<空格>5
`%F`	采用 YYYY-mm-dd 格式的日期，等于 %Y-%m-%d， (ISO 8601 日期格式)	2019-06-27
`%G`	与“Y”相同
`%g`	与“y”相同
`%H`	24 小时格式的小时	17
`%h`	与“b”相同
`%I`	12 小时格式的小时	05
`%j`	一年中的某一天	1-366
`%k`	与“H”相同
`%l`	与“I” (大写 I) 相同	05
`%M`	分钟数	35
`%m`	月份	06
`%n`	换行符
`%p`	上午或下午
`%R`	以 24 小时格式显示的时间 -无秒	17:45
`%r`	12 小时格式的时间	上午 09：15：36
`%S`	秒	05
`%s`	自 1970 年 1 月 1 日以来经过的秒 00：00：00	1150451174
`%t`	水平制表符
`%T`	24 小时格式的时间	17:45:52
`%U`	与“W”相同
`%u`	星期几 - 数字	星期日 = 0
`%V`	一年中的一周	01-53
`%w`	与“u”相同
`%W`	一年中的一周	00-52
`%X`	与“T”相同
`%x`	区域设置的标准格式的日期	06/27/19 英语-美国
`%Y`	4 位格式的年份	2019
`%y`	2 位格式的年份	19
`%Z`	与世界时坐标 (UTC) 的时区偏移量	-07