Formatar valores DateTime
Os valores do Armazenamento DateTime do Azure têm de ser representados como valores combinados de Hora Universal Coordenada (UTC). Os formatos UTC são descritos pelo ISO 8601.
Formatos ISO 8601 UTC aceites
Os seguintes formatos UTC ISO 8601 são atualmente aceites 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 nestes formatos, YYYY é uma representação de quatro dígitos, MM é uma representação mensal de dois dígitos a partir de 1 e DD é uma representação diária de dois dígitos a partir de 1.
Se o valor de hora opcional estiver incluído, é necessário um designador T literal para separar o valor de hora do valor de data. Para o valor de hora, hh é a representação de hora na notação de 24 horas, mm é a representação de dois dígitos e ss é a segunda representação de dois dígitos. Cada um destes valores é expresso como um número inteiro, começando em zero.
Se o valor de tempo incluir segundos, opcionalmente também pode incluir até 7 dígitos decimais de segundos fracionários, seguindo o padrão hh:mm:ss[.f{1,7}]. Este padrão é suportado pelas APIs de Armazenamento do Azure, ferramentas e bibliotecas de cliente. Tem de utilizar um período em vez de vírgulas para delinear o valor de segundos fracionários.
Se incluir o sufixo <TZDSuffix>de fuso horário opcional, este tem de ser expresso como:
- Um valor
Zliteral, que designa que o valor de hora é expresso como hora UTC; ou - Um desvio que indica o desvio de tempo da hora UTC. O desvio requer uma liderança
+para um desvio positivo e conduz-a um desvio negativo. O valor do desvio tem de estar entre -23:59 e +23:59.
Abaixo, é apresentado um exemplo do formato UTC combinado. A data é especificada primeiro, seguida do valor Tliteral , que designa o início do elemento de hora. O valor Z literal no final da cadeia indica que a hora é expressa em UTC.
O valor de data/hora de 16 de novembro de 2020 às 4:25:03 na hora UTC é expresso como:
2020-11-16T04:25:03Z
Para expressar o mesmo tempo na Hora Padrão Do Leste (EST), que é cinco horas antes dessa UTC, adicione o desvio ao valor:
2020-11-16T04:25:03-05:00