Formatação de valores datetime
Os valores do Armazenamento DateTime do Azure devem ser representados como valores UTC (Tempo Universal Coordenado) combinados. Os formatos UTC são descritos pela ISO 8601.
Formatos ISO 8601 UTC aceitos
Os seguintes formatos ISO 8601 UTC são atualmente aceitos pelo Armazenamento do Azure. O valor de data é necessário, enquanto o valor de hora é opcional:
YYYY-MM-DDYYYY-MM-DDThh:mm<TZDSuffix>YYYY-MM-DDThh:mm:ss<TZDSuffix>
Para o valor de data nesses formatos, YYYY é uma representação de ano de quatro dígitos, MM é uma representação de mês de dois dígitos começando em 1 e DD é uma representação de dia de dois dígitos começando em 1.
Se o valor de hora opcional for incluído, um designador T literal será necessário para separar o valor de hora do valor de data. Para o valor de hora, hh é a representação de hora em notação de 24 horas, mm é a representação de dois dígitos de minuto e ss é a representação de dois dígitos segundo. Cada um desses valores é expresso como um inteiro, começando em zero.
Se o valor de tempo incluir segundos, ele também poderá incluir até sete dígitos decimais de segundos fracionários, seguindo o padrão hh:mm:ss[.f{1,7}]. Esse padrão é compatível com as APIs, ferramentas e bibliotecas de cliente do Armazenamento do Azure. Você deve usar um período em vez de vírgulas para delinear o valor de segundos fracionários.
Se você incluir o sufixo <TZDSuffix>de fuso horário opcional , ele deverá ser expresso como:
- Um valor
Zliteral , designando que o valor de hora é expresso como hora UTC; ou - Um deslocamento que indica o desvio de tempo da hora UTC. O deslocamento requer uma liderança
+para um deslocamento positivo e à esquerda-para um deslocamento negativo. O valor do deslocamento deve ficar entre -23:59 e +23:59.
Um exemplo do formato UTC combinado é mostrado abaixo. A data é especificada primeiro, seguida pelo valor Tliteral , que designa o início do elemento time. O valor Z literal no final da cadeia de caracteres indica que a hora é expressa em UTC.
O valor de data/hora de 16 de novembro de 2020 às 4h25:03 no horário UTC é expresso como:
2020-11-16T04:25:03Z
Para expressar a mesma hora no Horário Padrão do Leste (EST), que é cinco horas antes desse UTC, adicione o deslocamento ao valor :
2020-11-16T04:25:03-05:00