Форматирование значений даты и времени

Значения службы хранилища DateTime Azure должны быть представлены в виде объединенных значений времени в формате 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}]. Этот шаблон поддерживается API службы хранилища Azure, средствами и клиентскими библиотеками. Для деления значения доли секунд необходимо использовать точку, а не запятую.

Если включить необязательный суффикс <TZDSuffix>часового пояса, он должен быть выражен следующим образом:

• Литеральное значение Z, обозначающее, что значение времени выражается как время в формате UTC; или
• Смещение, указывающее смещение времени от времени в формате UTC. Для смещения требуется ведущее + значение для положительного смещения и ведущее - для отрицательного смещения. Значение смещения должно находиться в диапазоне от -23:59 до +23:59.

Ниже приведен пример объединенного формата UTC. Сначала указывается дата, за которой следует литеральное значение T, обозначающее начало элемента времени. Литеральное значение Z в конце строки указывает, что время выражается в формате UTC.

Значение даты и времени для 16 ноября 2020 г. в 4:25:03 по времени UTC выражается следующим образом:

2020-11-16T04:25:03Z

Чтобы выразить то же время в восточном стандартном времени (EST), которое на пять часов раньше UTC, добавьте смещение к значению :

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

См. также раздел

Справочник по API-интерфейсу REST служб хранилища