Formatera DateTime-värden

  • Artikel

Azure Storage-värden DateTime måste representeras som kombinerade UTC-värden (Coordinated Universal Time). UTC-format beskrivs av ISO 8601.

Godkända ISO 8601 UTC-format

Följande ISO 8601 UTC-format godkänns för närvarande av Azure Storage. Datumvärdet krävs, medan tidsvärdet är valfritt:

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

För datumvärdet i dessa format YYYY är en fyrsiffrig årsrepresentation, MM en tvåsiffrig månadsrepresentation som börjar på 1 och DD är en tvåsiffrig dagrepresentation som börjar på 1.

Om det valfria tidsvärdet ingår krävs en literaldesignator T för att separera tidsvärdet från datumvärdet. För tidsvärdet hh är timrepresentationen i 24-timmarsnotation, mm är den tvåsiffriga minutrepresentationen och ss är den tvåsiffriga andra representationen. Vart och ett av dessa värden uttrycks som ett heltal, med början vid noll.

Om tidsvärdet innehåller sekunder kan det även innehålla upp till 7 decimalsiffror i bråksekunder, enligt mönstret hh:mm:ss[.f{1,7}]. Det här mönstret stöds av Azure Storage-API:er, verktyg och klientbibliotek. Du måste använda en punkt i stället för kommatecken för att definiera värdet för bråksekunder.

Om du inkluderar det valfria tidszonssuffixet <TZDSuffix>måste det uttryckas som antingen:

  • Ett literalvärde Zsom anger att tidsvärdet uttrycks som UTC-tid, eller
  • En förskjutning som anger tidsfördomar från UTC-tid. Förskjutningen kräver en ledande + för en positiv förskjutning och ledande - för en negativ förskjutning. Förskjutningens värde måste ligga mellan -23:59 och +23:59.

Ett exempel på det kombinerade UTC-formatet visas nedan. Datumet anges först, följt av literalvärdet T, som anger början av tidselementet. Literalvärdet Z i slutet av strängen anger att tiden uttrycks i UTC.

Datum-/tidsvärdet för den 16 november 2020 kl. 04:25:03 i UTC-tid uttrycks som:

2020-11-16T04:25:03Z

Om du vill uttrycka samma tid i Eastern Standard Time (EST), som är fem timmar tidigare än UTC, lägger du till förskjutningen i värdet:

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

Se även

Rest-API-referens för Azure Storage