格式化 DateTime 值

Azure 儲存體 DateTime 值必須以結合國際標準時間 (UTC) 值來表示。 UTC 格式是由 ISO 8601所描述。

接受的 ISO 8601 UTC 格式

Azure 儲存體目前接受下列 ISO 8601 UTC 格式。 需要日期值,而時間值是選擇性的:

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

對於這些格式的日期值而言, YYYY 是四位數年份標記法, MM 是從 1 開始的兩位數月份標記法,而且 DD 是從 1 開始的兩位數日期標記法。

如果包含選擇性時間值,則需要常值指示項 T ,才能將時間值與日期值分開。 針對時間值, hh 是 24 小時標記法中的小時標記法, mm 是兩位數的分鐘標記法,而 ss 是兩位數的第二個標記法。 每個值都會以整數表示,從零開始。

如果時間值包含秒數,它可能也會選擇性地包含最多 7 個小數位數的小數秒,並遵循模式 hh:mm:ss[.f{1,7}] 。 Azure 儲存體 API、工具和用戶端程式庫支援此模式。 您必須使用句號而非逗號來描述小數秒值。

如果您包含選擇性時區尾碼 <TZDSuffix> ,則必須以下列其中一種表示:

  • 常值 ,指定時間值 Z 以 UTC 時程表示;或
  • 表示 UTC 時間偏差的位移。 位移需要正位移的前置 + 和負位移的前置 - 。 位移的值必須介於 -23:59 和 +23:59 之間。

以下顯示合併 UTC 格式的範例。 會先指定日期,後面接著常值 ,這個值 T 會指定時間專案的開頭。 字串結尾的常值 Z 表示時間是以 UTC 表示。

2020 年 11 月 16 日上午 4:25:03的日期/時間值以 UTC 時程表示為:

2020-11-16T04:25:03Z

若要在東部標準時間 (EST) 中表示相同的時間,也就是該 UTC 之前的五小時,請將位移新增至值:

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

另請參閱

Azure 儲存體 REST API 參考