格式化 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