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-DDYYYY-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