DateTime 値の書式設定

DateTime Azure Storage値は、協定世界時 (UTC) の合計値として表す必要があります。 UTC 形式は ISO 8601 で記述されています。

許容される ISO 8601 UTC 形式

現在、次の ISO 8601 UTC 形式は、Azure Storageで受け入れ可能です。 日付値は必須ですが、時刻の値は省略可能です。

  • YYYY-MM-DD
  • YYYY-MM-DDThh:mm<TZDSuffix>
  • YYYY-MM-DDThh:mm:ss<TZDSuffix>

これらの形式の日付値の場合、 YYYY 4 桁の年表現、 MM 1 から始まる 2 桁の月表現、および DD 1 から始まる 2 桁の日表現です。

省略可能な時刻値が含まれている場合は、時刻値を日付値から分離するためにリテラル指定子 T が必要です。 時間値の場合は、 hh 24 時間表記の時間表現、 mm 2 桁の分表現、および ss 2 桁の 2 桁の秒表現です。 これらの各値は、0 から始まる整数で表されます。

時間の値に秒が含まれている場合は、必要に応じて、パターン hh:mm:ss[.f{1,7}]に従って、秒の小数部の最大 7 桁の小数部を含めることもできます。 このパターンは、Azure Storage API、ツール、クライアント ライブラリでサポートされています。 秒の小数部の値を示すには、コンマではなくピリオドを使用する必要があります。

オプションのタイム ゾーン サフィックス <TZDSuffix>を含める場合は、次のように表す必要があります。

  • 時間値が UTC 時刻として表されることを示すリテラル値 Z
  • UTC 時刻からの時間バイアスを示すオフセット。 オフセットには正のオフセットの場合は先頭 + 、負のオフセットの場合は先行 - が必要です。 オフセットの値は、-23:59 から +23:59 の間で指定する必要があります。

結合された UTC 形式の例を次に示します。 最初に日付を指定し、その後にリテラル値 Tを指定します。これは、time 要素の先頭を示します。 文字列の末尾にあるリテラル値 Z は、時刻が UTC で表されることを示します。

2020 年 11 月 16 日午前 4 時 25 分 03 分 (UTC 時刻) の日付/時刻の値は、次のように表されます。

2020-11-16T04:25:03Z

UTC の 5 時間前の東部標準時 (EST) で同じ時刻を表すには、値にオフセットを追加します。

2020-11-16T04:25:03-05:00

関連項目

Azure Storage REST API リファレンス