Форматирование значений даты и времени
Значения службы хранилища DateTime Azure должны быть представлены в виде объединенных значений времени в формате UTC. Форматы UTC описаны в стандарте ISO 8601.
Принятые форматы ISO 8601 UTC
В настоящее время служба хранилища Azure принимает следующие форматы ISO 8601 UTC. Значение даты является обязательным, а значение времени — необязательным:
YYYY-MM-DDYYYY-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