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:將三天新增至系統日期
此命令會將目前的系統日期增加 3 天。 它不會影響時間。 此命令會使用 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 來建立具有 90 分鐘間隔的 TimeSpan 物件,並將它儲存在變數中 $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
指定日期和時間的顯示專案。此參數可接受的值為:
- 日期 - 只顯示日期。
- 時間 - 只顯示時間。
- DateTime - 顯示日期和時間。
此參數只會影響顯示。
它不會影響擷取的 Get-Date
DateTime 物件。
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 |
輸入
您可以使用管線將日期傳送至 Set-Date
。
輸出
Set-Date
會傳回 物件,表示它設定的日期。
備註
變更電腦上的日期和時間時,請謹慎使用此 Cmdlet。 變更可能會導致電腦無法接收日期或時間觸發的全系統事件和更新。 使用 WhatIf 和 Confirm 參數來避免錯誤。
您可以使用標準 .NET 方法搭配搭配使用的
Set-Date
DateTime 和 TimeSpan 物件,例如 AddDays、AddMonths 和 FromFileTime。 如需詳細資訊,請參閱 DateTime 方法 及.NET SDK 中的 TimeSpan 方法。