Set-Date

  • リファレンス
モジュール:
Microsoft.PowerShell.Utility

指定する時刻にコンピューターのシステム時刻を変更します。

構文

Set-Date
   [-Date] <DateTime>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Date
   [-Adjust] <TimeSpan>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットは Set-Date 、コンピューター上のシステムの日付と時刻を、指定した日付と時刻に変更します。

新しい日付や時刻を指定するには、文字列を入力するか、DateTime または TimeSpan オブジェクトを Set-Date. 新しい日付または時刻を指定するには、Date パラメーターを使用します。 変更間隔を指定するには、Adjust パラメーターを使用します。

例

例 1: システム日付に 3 日を追加する

このコマンドは、現在のシステム日付に 3 日加算します。 時刻には影響しません。 このコマンドでは、Date パラメーターを使用して日付を指定します。

このコマンドレットは 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.

2 番目のコマンドでは、Date パラメーターを使用して DateTime オブジェクト$TをコマンドレットにSet-Date渡します。

$T = Get-Date
Set-Date -Date $T

例 4: システム クロックに 90 分を追加する

これらのコマンドは、ローカル コンピューターのシステム時刻を 90 分進めます。

最初のコマンドでは、コマンドレットをNew-TimeSpan使用して 90 分間隔の TimeSpan オブジェクトを作成し、変数に$90mins保存します。

2 番目のSet-Dateコマンドでは、Adjust パラメーターを使用して、変数内の TimeSpan オブジェクトの値で日付を$90mins調整します。

$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins

パラメーター

-Adjust

このコマンドレットが現在の日付と時刻を加算または減算する値を指定します。 では、ロケールの標準の日付と時刻形式で調整を入力するか、Adjust パラメーターを使用して TimeSpan オブジェクトNew-TimeSpanSet-Dateを渡すことができます。

Type:TimeSpan
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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 指定した日付の午前 0 時に時刻を変更します。 時刻だけを指定すると、日付は変わりません。

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

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

DateTime

このコマンドレットに日付をパイプできます。

出力

DateTime

このコマンドレットは、設定した日付を表すオブジェクトを返します。

メモ

  • コンピューターの日付と時刻を変更する場合は、このコマンドレットを慎重に使用してください。 変更によって、コンピューターが、日付または時刻に基づいてトリガーされるシステム全体のイベントと更新を受信できなくなる可能性があります。 エラーを回避するには、 WhatIf パラメーターと Confirm パラメーターを使用します。
  • 標準の .NET メソッドは、AddDays、AddMonths、FromFileTime など、DateTime オブジェクトと TimeSpan オブジェクトでSet-Date使用できます。 詳細については、「.NET SDK の DateTime メソッドと TimeSpan メソッド」を参照してください。