Get-Date

參考

模組:: Microsoft.PowerShell.Utility

取得目前的日期和時間。

Syntax

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

Description

Cmdlet 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 格式規範的清單，請參閱 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位移來轉換時間。 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：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 會使用 Format 參數搭配小寫 o 的格式規範來建立時間戳 String 物件。物件會向下傳送至 ForEach-Object管線。 ScriptBlock 包含$_代表目前管線物件的變數。時間戳字串是以句號取代的冒號分隔。

New-Item 會使用 Path 參數來指定新目錄的位置。路徑包含 $timestamp 變數做為目錄名稱。 Type 參數會指定建立目錄。

範例 9：轉換 Unix 時間戳

本範例會將從 1970-01-01-01 0：00：00) 起的秒數，將 Unix 時間 (轉換成 DateTime。

Get-Date -UnixTimeSeconds 1577836800

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

範例 10：傳回解譯為 UTC 的日期值

此範例示範如何將日期值解譯為其 UTC 對等專案。例如，此計算機會設定為 Pacific Standard Time。根據預設，會 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 物件轉換成 String 。不過，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

決定要顯示日期和時間的哪些元素。

接受的值如下所示：

日期：只顯示日期
時間：只顯示時間
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 位數的日期，以及以 UTC 指標) 的字母Z。例如：20190627Z。
FileDateTime。以 24 小時格式表示目前日期和時間的檔案或路徑易記表示法。格式 yyyyMMddTHHmmssffff (區分大小寫，使用 4 位數年份、2 位數月份、2 位數的日、以時間分隔符的字母 T 、2 位數小時、2 位數分鐘、2 位數秒和 4 位數毫秒) 。例如：20190627T0840107271。
FileDateTimeUniversal。通用時間 (UTC) 格式之目前日期和時間的檔案或路徑易記表示法。格式 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

輸入

DateTime

您可以使用管線將 DateTime 物件傳送至此 Cmdlet。

輸出

DateTime

根據預設，此 Cmdlet 會傳回 DateTime 物件。

當 DateTime 物件將管線向下傳送至 Cmdlet，例如 Add-Content 預期字串輸入的 Cmdlet 時，PowerShell 會將對象轉換成 String 物件。

會 ToString() 使用目前的文化特性設定，將 DateTime 物件轉換成 String 。不過，PowerShell 表達式解譯一律使用不可變的文化特性設定。若要查看不變異文化特性如何不同，請參閱範例 11。

若要顯示物件的屬性和方法，請將物件向下傳送至 Get-Member。例如： Get-Date | Get-Member 。

String

當您使用 Format 或 UFormat 參數時，此 Cmdlet 會傳回 String 物件。

備註

DateTime 物件輸出的預設格式是目前所選取地區設定的完整日期和時間格式。

下表顯示有效的 UFormat 規範 ：

重要

UFormat 規範會在較新版本的 PowerShell 中變更或新增。例如，%F已在 PowerShell 6.2 中新增，因此無法在 Windows PowerShell 5.1 或較舊版本中使用。在設計為在多個 PowerShell 版本上執行的腳本中使用 UFormat 規範時，請記住這點。

格式規範	意義	範例
`%A`	星期數 - 完整名稱	星期一
`%a`	星期數 - 縮寫名稱	Mon
`%B`	月份名稱 - 完整	January
`%b`	月份名稱 - 縮寫	一月
`%C`	世紀	2019年20日
`%c`	日期和時間 - 縮寫	2019 年 6 月 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`	包含星期四的 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
`%S`	秒	05
`%s`	自 1970 年 1 月 1 日起經過的秒數 00：00：00 (UTC)	1150451174
`%t`	水平索引標籤字元
`%T`	24 小時制的時間格式	17:45:52
`%U`	與『W』相同
`%u`	在 PowerShell 7.2) 中變更了一周的數值日期 (1-7) (	Monday = 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

Syntax

Description

範例

範例 1：取得目前的日期和時間

範例 2：取得目前日期和時間的元素

範例 3：使用 .NET 格式規範取得日期和時間

範例 4：使用 UFormat 規範取得日期和時間

範例 5：取得一年中的日期

範例 6：檢查日期是否已調整日光節約時間

範例 7：將目前時間轉換為 UTC 時間

範例 8：Create 時間戳

範例 9：轉換 Unix 時間戳

範例 10：傳回解譯為 UTC 的日期值

範例 11：顯示不因文化特性而異

參數

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

輸入

輸出

備註

其他資源

共用方式為

Get-Date

Syntax

Description

範例

範例 1：取得目前的日期和時間

範例 2：取得目前日期和時間的元素

範例 3：使用 .NET 格式規範取得日期和時間

範例 4：使用 UFormat 規範取得日期和時間

範例 5：取得一年中的日期

範例 6：檢查日期是否已調整日光節約時間

範例 7：將目前時間轉換為 UTC 時間

範例 8：Create 時間戳

範例 9：轉換 Unix 時間戳

範例 10：傳回解譯為 UTC 的日期值

範例 11：顯示不因文化特性而異

參數

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

輸入

輸出

備註

相關連結

其他資源