Set-Date

  • 參考
模組:
Microsoft.PowerShell.Utility

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

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 只顯示時間，但不會影響傳回的 Set-DateDateTime物件。

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 。

第二個命令會使用 的Adjust參數 Set-Date ，依變數中的 $90minsTimeSpan物件值來調整日期。

$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 - 顯示日期和時間。

此參數只會影響顯示。 它不會影響擷取的 Get-DateDateTime物件。

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

輸入

DateTime

您可以使用管線將日期傳送至此 Cmdlet。

輸出

DateTime

這個 Cmdlet 會傳回物件，代表它設定的日期。

備註

  • 變更電腦上的日期和時間時，請謹慎使用此 Cmdlet。 變更可能會導致電腦無法接收日期或時間觸發的全系統事件和更新。 使用 WhatIf 和 Confirm 參數來避免錯誤。
  • 您可以使用標準 .NET 方法搭配搭配 Set-Date 使用的DateTime和TimeSpan物件，例如AddDays、AddMonths和FromFileTime。 如需詳細資訊，請參閱 .NET SDK 中的 DateTime 方法和TimeSpan 方法 。