Formatação de valores datetime

Os valores Armazenamento DateTime do Azure devem ser representados como valores UTC (Tempo Universal Coordenado) combinados. Os formatos UTC são descritos pelo ISO 8601.

Formatos UTC iso 8601 aceitos

Os seguintes formatos ISO 8601 UTC são atualmente aceitos pelo Armazenamento do Azure. O valor da data é necessário, enquanto o valor de hora é opcional:

  • YYYY-MM-DD
  • YYYY-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 dois dígitos mês a partir de 1 e DD é uma representação de dois dígitos dia a partir de 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 da data. Para o valor de tempo, hh é a representação de hora na notação de 24 horas, mm é a representação de dois dígitos de minutos 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é 7 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 Azure Armazenamento. 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 viés de tempo da hora UTC. O deslocamento requer uma liderança + para um deslocamento positivo e levando - a 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 elemento de início da hora. O valor Z literal no final da cadeia de caracteres indica que a hora é expressa em UTC.

O valor de data/hora para 16 de novembro de 2020 às 4:25:03 am 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 que UTC, adicione o deslocamento ao valor:

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

Confira também

Referência de API REST do Armazenamento do Azure