Formatieren von DateTime-Werten
Azure Storage-Werte DateTime müssen als kombinierte UTC-Werte (Coordinated Universal Time) dargestellt werden. UTC-Formate werden in ISO 8601 beschrieben.
Akzeptierte ISO 8601 UTC-Formate
Die folgenden ISO 8601 UTC-Formate werden derzeit von Azure Storage akzeptiert. Der Datumswert ist erforderlich, während der Zeitwert optional ist:
YYYY-MM-DDYYYY-MM-DDThh:mm<TZDSuffix>YYYY-MM-DDThh:mm:ss<TZDSuffix>
Für den Datumswert in diesen Formaten YYYY ist eine vierstellige Jahresdarstellung, MM eine zweistellige Monatsdarstellung ab 1 und DD eine zweistellige Tagesdarstellung ab 1.
Wenn der optionale Zeitwert enthalten ist, ist ein Literalentwurf T erforderlich, um den Zeitwert vom Datumswert zu trennen. Für den Zeitwert hh ist die Stundendarstellung in 24-Stunden-Notation, mm die zweistellige Minutendarstellung und ss die zweistellige zweite Darstellung. Jeder dieser Werte wird als ganze Zahl ausgedrückt, beginnend bei null.
Wenn der Zeitwert Sekunden enthält, kann er optional auch bis zu 7 Dezimalstellen von Sekundenbruchteilen nach dem Muster hh:mm:ss[.f{1,7}]enthalten. Dieses Muster wird von den Azure Storage-APIs, -Tools und -Clientbibliotheken unterstützt. Sie müssen einen Punkt anstelle von Kommas verwenden, um den Sekundenbruchwert abzugrenzen.
Wenn Sie das optionale Zeitzonensuffix <TZDSuffix>einschließen, muss es als eines der folgenden Ausdrücke ausgedrückt werden:
- Ein Literalwert
Z, der angibt, dass der Zeitwert als UTC-Zeit ausgedrückt wird; oder - Ein Offset, der die Zeitverzerrung ab UTC-Zeit angibt. Der Offset erfordert eine Führung
+für einen positiven Offset und eine Führung-für einen negativen Offset. Der Wert des Offsets muss zwischen -23:59 und +23:59 liegen.
Ein Beispiel für das kombinierte UTC-Format ist unten dargestellt. Das Datum wird zuerst angegeben, gefolgt vom Literalwert T, der den Anfang des Zeitelements angibt. Der Literalwert Z am Ende der Zeichenfolge gibt an, dass die Zeit in UTC ausgedrückt wird.
Der Datums-/Uhrzeitwert für den 16. November 2020 um 4:25:03 Uhr in UTC-Zeit wird wie folgt ausgedrückt:
2020-11-16T04:25:03Z
Um die gleiche Zeit in der Östlichen Standardzeit (EST) auszudrücken, die fünf Stunden früher als UTC liegt, fügen Sie den Offset zum Wert hinzu:
2020-11-16T04:25:03-05:00