你当前正在访问 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

另请参阅

Azure 存储 REST API 参考