Get-Date
取得目前的日期和時間。
Syntax
Get-Date
[[-Date] <DateTime>]
[-Year <Int32>]
[-Month <Int32>]
[-Day <Int32>]
[-Hour <Int32>]
[-Minute <Int32>]
[-Second <Int32>]
[-Millisecond <Int32>]
[-DisplayHint <DisplayHintType>]
[-Format <String>]
[<CommonParameters>]
Get-Date
[[-Date] <DateTime>]
[-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 參數會指定建立目錄。
參數
-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) 格式之目前日期和時間的檔案或路徑易記表示法。 格式
yyyyMMddTHHmmssffffZ
(區分大小寫,使用 4 位數年份、2 位數月份、2 位數日期、字母T
做為時間分隔符、2 位數小時、2 位數分鐘、2 位數秒、4 位數毫秒,以及以 UTC 指標表示的字母Z
) 。 例如: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 |
-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
預期字串輸入的 Cmdlet 時,PowerShell 會將對象轉換成 String 物件。
方法 (Get-Date).ToString()
會將 DateTime 物件轉換為 String 物件。
若要顯示物件的屬性和方法,請將物件向下傳送至 Get-Member
。
例如: Get-Date | Get-Member
。
備註
DateTime 對像是系統地區設定的長日期和時間格式。
下表顯示有效的 UFormat 規範 :
格式規範 | 意義 | 範例 |
---|---|---|
%A |
星期數 - 完整名稱 | 星期一 |
%a |
星期數 - 縮寫名稱 | Mon |
%B |
月份名稱 - 完整 | January |
%b |
月份名稱 - 縮寫 | 一月 |
%C |
世紀 | 2019年20日 |
%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 |
與 『Y』 相同 | |
%g |
與 『y』 相同 | |
%H |
24 小時格式的小時 | 17 |
%h |
與 『b』 相同 | |
%I |
12 小時格式的小時 | 05 |
%j |
一年中的日 | 1-366 |
%k |
與 『H』 相同 | |
%l |
與 『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: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 |