Formattazione di valori DateTime

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

Formati UTC ISO 8601 accettati

I formati UTC ISO 8601 seguenti sono attualmente accettati da archiviazione di Azure. Il valore della data è obbligatorio, mentre il valore dell'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 di un mese a due cifre a partire da 1 ed DD è una rappresentazione del giorno a due cifre a partire da 1.

Se è incluso il valore di ora facoltativo, è necessario un indicatore letterale T per separare il valore dell'ora dal valore di data. Per il valore time, hh è la rappresentazione dell'ora nella notazione a 24 ore, mm è la rappresentazione a due cifre al minuto e ss è la rappresentazione in secondi a due cifre. Ognuno di questi valori è espresso come Integer, a partire da zero.

Se il valore dell'ora include secondi, può includere 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 utilizzare un punto anziché una virgola.

Se si include il suffisso del fuso orario facoltativo <TZDSuffix> , è necessario che sia espresso come:

  • Valore letterale Z che indica che il valore dell'ora è espresso come ora UTC; oppure
  • Offset che indica la distorsione temporale dall'ora UTC. Per l'offset è necessario un valore leader + 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 letterale T , che designa l'inizio dell'elemento time. Il valore letterale Z 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 am nell'ora UTC è espresso come:

2020-11-16T04:25:03Z

Per esprimere lo stesso tempo nell'ora solare fuso orientale (EST), che corrisponde a cinque ore prima dell'ora UTC, aggiungere l'offset al valore:

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

Vedi anche

Riferimento all'API REST di archiviazione di Azure