Set-Date
將電腦上的系統時間變更為您指定的時間。
Syntax
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-Date
[-Adjust] <TimeSpan>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdlet 會將 Set-Date
電腦上的系統日期和時間變更為您指定的日期和時間。
您可以輸入字串或將 DateTime 或 TimeSpan 物件傳遞至 Set-Date
,以指定新的日期和時間和/或時間。 若要指定新的日期或時間,請使用 Date 參數。
若要指定變更間隔,請使用 Adjust 參數。
範例
範例 1:將三天新增至系統日期
此命令會將三天新增至目前的系統日期。 這不會影響時間。 命令會 使用 Date 參數來指定日期。
Cmdlet 會將 Get-Date
目前的日期當做 DateTime 物件傳回。 DateTime 物件的 AddDays 方法會將指定的天數 (3
) 新增至目前的 DateTime 物件。
Set-Date -Date (Get-Date).AddDays(3)
範例 2:將系統時鐘設定回 10 分鐘
本範例會將目前的系統時間設定為10分鐘。
Adjust 參數可讓您以地區設定的標準時間格式指定變更間隔 (減去 10 分鐘)。
DisplayHint 參數會指示 PowerShell 只顯示時間,但不會影響傳回的 DateTime 物件Set-Date
。
Set-Date -Adjust -0:10:0 -DisplayHint Time
範例 3:將日期和時間設定為變數值
這些命令會將本機電腦上的系統日期和時間變更為變數 $T
中所儲存的日期和時間。 第一個命令會取得日期,並將它儲存在 $T
中。
第二個命令會使用 Date 參數,將中的 DateTime 對象$T
傳遞至 Set-Date
Cmdlet。
$T = Get-Date
Set-Date -Date $T
範例 4:將 90 分鐘新增至系統時鐘
這些命令會將本機電腦上的系統時間提前 90 分鐘。
第一個命令會New-TimeSpan
使用 Cmdlet 來建立 TimeSpan 物件,間隔為 90 分鐘,並將它儲存在變數中$90mins
。
第二個命令會使用 的 Set-Date
Adjust 參數,依變數中 $90mins
TimeSpan 物件的值來調整日期。
$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins
參數
-Adjust
指定這個 Cmdlet 從目前日期和時間加入或減去的值。
可以輸入地區設定的標準日期和時間格式調整,或使用 Adjust 參數將 TimeSpan 物件從 New-TimeSpan
傳遞至 Set-Date
。
Type: | TimeSpan |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前先提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Date
將日期和時間變更為指定的值。
您可以輸入簡短日期格式的新日期,並以地區設定的標準時間格式輸入時間。 或者,您可以從 傳遞 DateTime 物件 Get-Date
。
如果您指定日期,但不是時間, Set-Date
請將指定日期的時間變更為午夜。 如果您只指定時間,則不會變更日期。
Type: | DateTime |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayHint
指定顯示日期和時間的專案。此參數可接受的值為:
Date
- 只顯示日期。Time
- 只顯示時間。DateTime
- 顯示日期和時間。
此參數只會影響顯示器。
它不會影響擷取的 DateTime 物件 Get-Date
。
Type: | DisplayHintType |
Accepted values: | Date, Time, DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
您可以使用管線將日期傳送至此 Cmdlet。
輸出
此 Cmdlet 會傳回 物件,代表其設定的日期。
備註
- 變更電腦上的日期和時間時,請謹慎使用此 Cmdlet。 變更可能會防止電腦接收由日期或時間觸發的系統範圍事件和更新。 使用 WhatIf 和 Confirm 參數來避免錯誤。
- 您可以使用標準 .NET 方法搭配搭配使用的
Set-Date
DateTime 和 TimeSpan 物件,例如 AddDays、AddMonths 和 FromFileTime。 如需詳細資訊,請參閱 .NET SDK 中的 DateTime 方法和TimeSpan 方法 。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應