Condividi tramite


Formattazione dei valori DateTime

I valori di Archiviazione di DateTime Azure devono essere rappresentati come valori UTC (Coordinated Universal Time) combinati. I formati UTC sono descritti da ISO 8601.

Formati ISO 8601 UTC accettati

I formati UTC ISO 8601 seguenti sono attualmente accettati da Archiviazione di Azure. Il valore di data è obbligatorio, mentre il valore di ora è facoltativo:

  • YYYY-MM-DD
  • YYYY-MM-DDThh:mm<TZDSuffix>
  • YYYY-MM-DDThh:mm:ss<TZDSuffix>

Per il valore di data in questi formati, YYYY è una rappresentazione dell'anno a quattro cifre, MM è una rappresentazione mensile a due cifre a partire da 1 ed DD è una rappresentazione di giorno a due cifre a partire da 1.

Se il valore di ora facoltativo è incluso, è necessario un designatore letterale T per separare il valore di ora dal valore di data. Per il valore di ora, hh è la rappresentazione dell'ora nella notazione di 24 ore, mm è la rappresentazione di minuto a due cifre e ss rappresenta la seconda rappresentazione a due cifre. Ognuno di questi valori viene espresso come intero, a partire da zero.

Se il valore di tempo include secondi, può includere facoltativamente anche fino a 7 cifre decimali di secondi frazionari, seguendo il modello hh:mm:ss[.f{1,7}]. Questo modello è supportato dalle API, dagli strumenti e dalle librerie client di Archiviazione di Azure. Per delineare il valore dei secondi frazionari, è necessario usare un punto anziché una virgola.

Se si include il suffisso <TZDSuffix>facoltativo del fuso orario, deve essere espresso come segue:

  • Valore letterale Z, designando che il valore dell'ora è espresso come ora UTC; o
  • Offset che indica la distorsione dell'ora UTC. L'offset richiede un valore iniziale + per un offset positivo e un - offset negativo. Il valore dell'offset deve essere compreso tra -23:59 e +23:59.

Di seguito è riportato un esempio del formato UTC combinato. La data viene specificata per prima, seguita dal valore Tletterale , che definisce l'inizio dell'elemento time. Il valore Z letterale alla fine della stringa indica che l'ora è espressa in formato UTC.

Il valore di data/ora per il 16 novembre 2020 alle 4:25:03 dell'ora UTC è espresso come segue:

2020-11-16T04:25:03Z

Per esprimere la stessa ora nell'ora solare orientale (EST), ovvero cinque ore prima dell'ora UTC, aggiungere l'offset al valore:

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

Vedi anche

Informazioni di riferimento sulle API REST di Archiviazione di Azure