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>]

说明

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

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

示例

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

在此示例中，Get-Date 显示当前系统日期和时间。输出采用长日期和长时间格式。

Get-Date

Tuesday, June 25, 2019 14:53:32

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

此示例演示如何使用 Get-Date 获取日期或时间元素。该参数使用自变量 Date、Time 或 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 格式说明符的列表，请参阅“注释”部分。

示例 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 变量用于存储当前系统日期和时间。 $TimeToUniversalTime()使用该方法根据计算机的 UTC 偏移量转换时间。

示例 8：创建时间戳

在此示例中，格式说明符为目录名称创建时间戳 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

示例 11：显示固定区域性

使用ToString()当前区域性设置将 DateTime 对象转换为字符串。但是，PowerShell 表达式解释始终使用固定区域性设置。

例如，在具有 en-US 区域性的系统上， ToString() 该方法使用 en-US 区域性设置设置日期。

# Get date using current culture en-US
(Get-Date 2024-03-19).ToString()

3/19/2024 12:00:00 AM

# Get date using invariant culture
"$(Get-Date 2024-03-19)"

03/19/2024 00:00:00

参数

-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。以当前所选区域设置的标准格式输入日期和时间。可以使用 cmdlet 更改当前区域设置 Set-Culture 。

例如，在“美国(英语)”中：

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 4 -Day 31显示 5 月 1 日，而不是 4 月 31 日。

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

-DisplayHint

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

接受的值如下所示：

Date：仅显示日期
Time：仅显示时间
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 作为 UTC 指示符、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。 “注释”部分包含一个有效的 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

输入

DateTime

可以将 DateTime 对象通过管道传递给此 cmdlet。

输出

DateTime

默认情况下，此 cmdlet 会返回一个 DateTime 对象。

当 DateTime 对象通过管道向下发送到需要字符串输入的 cmdlet（例如 Add-Content）时，PowerShell 会将对象转换为 String 对象。

使用 ToString() 当前区域性设置将 DateTime 对象转换为 字符串 。但是，PowerShell 表达式解释始终使用固定区域性设置。若要查看固定区域性的不同程度，请参阅示例 11。

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

String

当使用 Format 或 UFormat 参数时，此 cmdlet 将返回 String 对象。

备注

DateTime 对象的输出的默认格式是当前所选区域设置的长日期和时间格式。

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

重要

可在较新版本的 PowerShell 中更改或添加 UFormat 说明符。例如，%F 已添加到 PowerShell 6.2 中，因此它不适用于 Windows PowerShell 5.1 或更高版本。在设计为在多个版本的 PowerShell 上运行的脚本中使用 UFormat 说明符时，请记住这一点。

格式说明符	含义	示例
`%A`	星期几 - 完整名称	星期一
`%a`	星期几 - 缩写名称	Mon
`%B`	月份名称 - 完整	1 月
`%b`	月份名称 - 缩写	一月
`%C`	世纪	20，对应 2019
`%c`	日期和时间 - 缩写	2019 年 6 月 27 日星期四 08:44:18
`%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`	ISO 周日期年份（包含星期四的年份）
`%g`	与“G”相同 - 2 位数
`%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 AM
`%S`	秒	05
`%s`	自 1970 年 1 月 1 日 00:00:00 (UTC) 以来过去的秒数	1150451174
`%t`	垂直制表符
`%T`	时间采用 24 小时格式	17:45:52
`%U`	与“W”相同
`%u`	一周中的数值日期 (1-7)（已在 PowerShell 7.2 中更改）	星期一 = 1，星期日 = 7
`%V`	一年中的第几周	01-53
`%w`	一周中的数值日期 (0-6)	星期日 = 0，星期六 = 6
`%W`	一年中的第几周	00-52
`%X`	与“T”相同
`%x`	日期采用区域设置的标准格式	06/27/19（英语-美国）
`%Y`	年份采用 4 位格式	2019
`%y`	年份采用 2 位格式	19
`%Z`	与协调世界时 (UTC) 的时区偏移量	-07

注意

-UFormat %s 的行为已更改为修复 Windows PowerShell 中的行为问题。

返回值基于 UTC 时间。
该值是一个整数秒值（无小数部分）。

Get-Date

语法

说明

示例

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

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

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

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

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

示例 6：检查日期是否调整为夏令时

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

示例 8：创建时间戳

示例 9：转换 Unix 时间戳

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

示例 11：显示固定区域性

参数

-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：创建时间戳

示例 9：转换 Unix 时间戳

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

示例 11：显示固定区域性

参数

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

输入

输出

备注

相关链接

反馈

其他资源