你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
设置 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