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

通过

Get-Date

语法

说明

示例

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

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

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

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

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

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

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

示例 8：Create时间戳

示例 9：转换 Unix 时间戳

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

参数

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

输入

输出

备注

其他资源

通过

Get-Date

语法

说明

示例

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

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

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

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

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

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

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

示例 8：Create时间戳

示例 9：转换 Unix 时间戳

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

参数

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

输入

输出

备注

相关链接

其他资源