Set-Date

發行項
10/30/2009

將電腦的系統時間變更為指定的時間。

語法

Set-Date [-Adjust] <TimeSpan> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]

Set-Date [-Date] <DateTime> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]

描述

Set-Date Cmdlet 可將電腦的系統日期和時間變更為您所指定的日期和時間。輸入字串，或傳遞 DateTime 或 TimeSpan 物件給 Set-Date，即可指定新的日期和/或時間。若要指定新的日期或時間，請使用 Date 參數。若要指定變更的間隔，請使用 Adjust 參數。

參數

-Adjust <TimeSpan>

從目前的日期和時間加上或減去指定的值。您可以為您的地區設定以標準日期和時間格式輸入調整值，或使用 Adjust 參數將 TimeSpan 物件從 New-TimeSpan 傳遞到 Set-Date。

必要?	true
位置?	1
預設值
接受管線輸入?	true (ByPropertyName)
接受萬用字元?	false

-Date <DateTime>

將日期和時間變更為指定的值。您可依所在地區輸入簡短日期格式的新日期，以及標準時間格式的新時間。或者，您可以從 Get-Date 傳遞 Date-Time 物件。

若僅指定日期而未指定時間，Set-Date 會將時間變更為指定日期當天的午夜。若僅指定時間，日期將維持不變。

必要?	true
位置?	1
預設值
接受管線輸入?	true (ByValue, ByPropertyName)
接受萬用字元?	false

-DisplayHint <DisplayHintType>

決定所要顯示的日期和時間元素

有效的值包括：

-- date：僅顯示日期

-- time：僅顯示時間

-- datetime：顯示日期和時間

此參數只會影響顯示，不會影響 Get-Date 擷取的 DateTime 物件。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Confirm

在執行命令前先提示確認。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-WhatIf

說明執行命令時將會發生何種情況，但不會實際執行命令。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.DateTime

您可經由管道將日期輸出至 Set-Date。

輸出

System.DateTime

Set-Date 會傳回代表它所設定之日期的物件。

附註

請審慎使用這個 cmdlet。變更電腦的日期和時間。此項變更可能妨礙電腦接收依據日期或時間所觸發的全系統事件與更新。請使用 -WhatIf 和 -Confirm 參數來避免錯誤。

您可以使用標準的 .NET 方法搭配 Set-Date 所使用的 DateTime 和 TimeSpan 物件，如 AddDays、AddMonths 和 FromFileTime。如需詳細資訊，請參閱「DateTime 方法」和「TimeSpan 方法」。

範例 1

C:\PS>Set-Date -Date (Get-Date).AddDays(3)

描述
-----------
這個命令將目前的系統日期加上 3 日。這不會影響時間。命令使用 Date 參數來指定日期。它會使用 Get-Date Cmdlet 來取得目前的日期和時間，並以 3 (日) 的值來套用 DateTime 物件的 .NET 方法 AddDays。

範例 2

C:\PS>set-date -adjust -0:10:0 -displayHint time

描述
-----------
這個命令將目前的系統時間往回設定 10 分鐘。它使用 Adjust 參數指定變更的間隔，而時間即依照地區設定的標準時間格式產生變更 (減去 10 分鐘)。DisplayHint 參數指示 Windows PowerShell 僅顯示時間，但是這不會影響 Set-Date 傳回的 DateTime 物件。

範例 3

C:\PS>$t = get-date

C:\PS>set-date -date $t

描述
-----------
這些命令會將電腦的系統日期和時間變更為儲存在變數 $t 中的日期和時間。第一個命令會取得日期並將它儲存在 $t 中。第二個命令會使用 Date 參數，將 $t 中的 DateTime 物件傳遞給 Set-Date Cmdlet。

範例 4

C:\PS>$90mins = new-timespan -minutes 90

C:\PS>set-date -adjust $90mins

描述
-----------
這些命令將本機電腦的系統時間提前 90 分鐘。第一個命令會使用 New-Timespan Cmdlet，以 90 分鐘的間隔建立 TimeSpan 物件，然後將 TimeSpan 物件儲存在 $90mins 變數中。第二個命令會使用 Set-Date 的 Adjust 參數，依據 $90mins 變數中的 TimeSpan 物件值調整日期。

請參閱

概念

Get-Date
New-TimeSpan

共用方式為