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 cmdlet 获取表示当前日期或指定日期的 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 获取日期或时间元素。该 参数使用日期、时间或 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 偏移量用于转换时间。 Notes 部分中的表列出了有效的 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：创建时间戳

在此示例中，格式说明符为目录名称创建时间戳 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 参数来创建时间戳 String 对象。将对象向下发送到管道 ForEach-Object。 ScriptBlock 包含表示当前管道对象的 $_ 变量。时间戳字符串由用句点替换的冒号分隔。

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

示例 9：转换 Unix 时间戳

本示例将 Unix 时间（由自 1970-01-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 中引入的。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Date

指定日期和时间。时间是可选的，如果未指定，则返回 00：00：00。以当前所选区域设置的标准格式输入日期和时间。可以使用 Set-Culture cmdlet 更改当前区域设置。

例如，美国英语：

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

类型:	DateTime
别名:	LastWriteTime
Position:	0
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Day

指定显示的月份日期。输入从 1 到 31 的值。

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

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayHint

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

接受的值如下所示：

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

类型:	DisplayHintType
接受的值:	Date, Time, DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	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。以 24 小时格式表示当前日期和时间的文件或路径友好表示形式（UTC）。格式 yyyyMMddTHHmmssffffZ（区分大小写，使用 4 位数年份、2 位数月份、2 位天、2 位天、字母 T 作为时间分隔符、2 位小时、2 位数分钟、2 位数秒、4 位数毫秒，并将字母 Z 作为 UTC 指示器）。例如：20190627T1540500718Z。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Hour

指定显示的小时。输入从 0 到 23 的值。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Millisecond

指定日期中的毫秒。输入从 0 到 999 的值。

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

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Minute

指定显示的分钟。输入从 0 到 59 的值。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Month

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

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Second

指定显示的第二个值。输入从 0 到 59 的值。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UFormat

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

UFormat 说明符前面有百分号（%），例如 %m、%d和 %Y。 Notes 节包含有效 UFormat 说明符表。

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UnixTimeSeconds

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

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

类型:	Int64
别名:	UnixTime
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Year

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

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	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`	星期几 - 缩写名称	星期一
`%B`	月名 - 完整	一月
`%b`	月份名称 - 缩写	1 月
`%C`	世纪	20 for 2019
`%c`	日期和时间 - 缩写	Thu Jun 27 08：44：18 2019
`%D`	以 mm/dd/y 格式表示的日期	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`	AM 或 PM
`%R`	24 小时格式的时间 -no 秒	17:45
`%r`	12 小时格式的时间	上午 09：15：36
`%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 中更改）	Monday = 1，星期日 = 7
`%V`	一年中的一周	01-53
`%w`	一周的数字日（0-6）	星期日 = 0，星期六 = 6
`%W`	一年中的一周	00-52
`%X`	与“T”相同
`%x`	区域设置的标准格式的日期	06/27/19 for English-US
`%Y`	4 位格式的年份	2019
`%y`	2 位数格式的年份	19
`%Z`	与世界时坐标（UTC）的时区偏移量	-07

注意

-UFormat %s 的行为已更改，以解决 Windows PowerShell 中行为的问题。

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

通过