Get-Date

Get-Date コマンドレットは、現在の日付または指定した日付を表す DateTime オブジェクトを取得します。 Get-Date では、日付と時刻を複数の .NET 形式と UNIX 形式で書式設定できます。 Get-Date を使用して日付または時刻の文字列を生成し、その文字列を他のコマンドレットまたはプログラムに送信できます。

Get-Date コンピューターのカルチャ設定を使用して、出力の書式設定方法を決定します。 コンピューターの設定を表示するには、(Get-Culture).DateTimeFormatを使用します。

この例では、Get-Date は現在のシステムの日付と時刻を表示します。 出力は、長い日付形式と長い時間形式です。

Get-Date

Tuesday, June 25, 2019 14:53:32

この例では、Get-Date を使用して日付要素または時刻要素を取得する方法を示します。 このパラメーターでは、Date 、Time、または DateTime 引数を使用します。

Get-Date -DisplayHint Date

Tuesday, June 25, 2019

Get-Date では、DisplayHint パラメーターと Date 引数を使用して、日付のみを取得します。

この例では、.NET 書式指定子を使用して出力の形式をカスタマイズします。 出力は、String オブジェクトです。

Get-Date -Format "dddd MM/dd/yyyy HH:mm K"

Tuesday 06/25/2019 16:17 -07:00

Get-Date では、Format パラメーターを使用して、複数の書式指定子を指定します。

この例で使用される .NET 書式指定子は、次のように定義されています。

.NET 書式指定子の詳細については、「カスタム日時書式指定文字列 を参照してください。

この例では、出力の形式をカスタマイズするために、いくつかの UFormat 書式指定子を使用します。 出力は、String オブジェクトです。

Get-Date -UFormat "%A %m/%d/%Y %R %Z"

Tuesday 06/25/2019 16:19 -07

Get-Date では、UFormat パラメーターを使用して、複数の書式指定子を指定します。

この例で使用する UFormat 書式指定子は、次のように定義されます。

有効な UFormat 書式指定子の一覧については、「Notes」セクションを参照してください。

この例では、プロパティを使用して年の数値の日を取得します。

グレゴリオ暦には、366 日の閏年を除き、365 日があります。 たとえば、2020 年 12 月 31 日は 366 日です。

(Get-Date -Year 2020 -Month 12 -Day 31).DayOfYear

366

Get-Date では、3 つのパラメーターを使用して日付を指定します。年の、月の、日のです。 コマンドはかっこで囲まれ、結果は DayofYear プロパティによって評価されます。

この例では、ブール型メソッドを使用して、日付が夏時間によって調整されているかどうかを確認します。

$DST = Get-Date
$DST.IsDaylightSavingTime()

True

変数 $DST、Get-Dateの結果を格納します。 $DST IsDaylightSavingTime メソッドを使用して、日付が夏時間に合わせて調整されているかどうかをテストします。

この例では、現在の時刻は UTC 時刻に変換されます。 時刻の変換には、システムのロケールの UTC オフセットが使用されます。 Notes セクションのテーブルには、有効な UFormat 書式指定子が一覧表示されます。

Get-Date -UFormat "%A %B/%d/%Y %T %Z"
$Time = Get-Date
$Time.ToUniversalTime()

Wednesday June/26/2019 10:45:26 -07

Wednesday, June 26, 2019 17:45:26

Get-Date は、UFormat パラメーターと書式指定子を使用して、現在のシステムの日付と時刻を表示します。 書式指定子 %Z は、-07 の UTC オフセット表します。

$Time 変数には、現在のシステムの日付と時刻が格納されます。 $Time ToUniversalTime() メソッドを使用して、コンピューターの UTC オフセットに基づいて時刻を変換します。

この例では、書式指定子によって、ディレクトリ名の文字列 オブジェクト タイムスタンプが作成されます。 タイムスタンプには、日付、時刻、および UTC オフセットが含まれます。

$timestamp = Get-Date -Format o | ForEach-Object { $_ -replace ":", "." }
New-Item -Path C:\Test\$timestamp -Type Directory

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         6/27/2019    07:59                2019-06-27T07.59.24.4603750-07.00

$timestamp 変数には、Get-Date コマンドの結果が格納されます。 Get-Date では、Format パラメーターと小文字の o の書式指定子を使用して、String オブジェクト タイムスタンプを作成します。 オブジェクトはパイプラインを ForEach-Objectに送信されます。 ScriptBlock には、現在のパイプライン オブジェクトを表す $_ 変数が含まれています。 タイムスタンプ文字列は、ピリオドに置き換えられるコロンで区切られます。

New-Item では、Path パラメーターを使用して、新しいディレクトリの場所を指定します。 パスには、ディレクトリ名として $timestamp 変数が含まれています。 Type パラメーターは、ディレクトリが作成されることを指定します。

Pipeline input

Get-Date はパイプライン入力を受け入れます。 たとえば、Get-ChildItem | Get-Date のようにします。

System.DateTime or System.String

Get-Date Format パラメータと UFormat パラメータが使用されている場合を除き、DateTime オブジェクトを返します。 Format または UFormat パラメータは String オブジェクトを返します。

DateTime オブジェクトが、文字列入力を必要とする Add-Content などのコマンドレットにパイプラインに送信されると、PowerShell はオブジェクトを String オブジェクトに変換します。

このメソッドは、(Get-Date).ToString() オブジェクトを String オブジェクトに変換する。

オブジェクトのプロパティとメソッドを表示するには、パイプラインの下にオブジェクトを送信して Get-Memberします。 たとえば、Get-Date | Get-Member のようにします。

DateTime オブジェクトは、システムロケールの長い日付形式と長い時刻形式です。

有効な UFormat 指定子 を次の表に示します。