DateTime-értékek formázása
Az Azure Storage-értékeket DateTime kombinált, koordinált egyetemes idő (UTC) értékként kell ábrázolni. Az UTC formátumokat az ISO 8601 írja le.
Elfogadott ISO 8601 UTC formátumok
Az Azure Storage jelenleg az alábbi ISO 8601 UTC formátumokat fogadja el. A dátumérték megadása kötelező, míg az időérték megadása nem kötelező:
YYYY-MM-DDYYYY-MM-DDThh:mm<TZDSuffix>YYYY-MM-DDThh:mm:ss<TZDSuffix>
Ezekben a formátumokban YYYY a dátumérték egy négyjegyű évábra, MM egy kétjegyű havi ábrázolás 1-től kezdődően, és DD egy kétjegyű napi reprezentáció 1-től kezdődően.
Ha a választható időértéket is tartalmazza, a dátumértéktől való elválasztásához literális tervezőre T van szükség. Az időérték hh az óra ábrázolása 24 órás jelölésben, mm a kétjegyű perc ábrázolás, a ss kétjegyű második ábrázolás. Ezek az értékek egész számként vannak kifejezve, nullától kezdve.
Ha az időérték másodperceket is tartalmaz, a mintát hh:mm:ss[.f{1,7}]követve akár 7 tizedesjegyet is tartalmazhat. Ezt a mintát az Azure Storage API-k, eszközök és ügyfélkódtárak támogatják. A tört másodperc értékének pontosvessző helyett egy pontot kell használnia.
Ha a választható időzóna-utótagot <TZDSuffix>is tartalmazza, azt a következőképpen kell kifejezni:
- Egy literális érték
Z, amely azt adja meg, hogy az időérték UTC-időként van kifejezve; vagy - Eltolás, amely az UTC-idő időeltolódását jelzi. Az eltoláshoz pozitív eltoláshoz és
+negatív eltoláshoz vezetőre-van szükség. Az eltolás értékének -23:59 és +23:59 közé kell esnie.
Alább látható egy példa a kombinált UTC formátumra. Először a dátumot adja meg, majd a literális értéket T, amely az időelem kezdetét jelöli. A sztring végén lévő literális érték Z azt jelzi, hogy az idő UTC-ben van kifejezve.
A 2020. november 16-án 04:25:03-kor (UTC) megadott dátum/idő érték a következőképpen van kifejezve:
2020-11-16T04:25:03Z
Ha ugyanazt az időpontot szeretné kifejezni a keleti téli idő (EST) szerint, amely öt órával korábbi az UTC-nél, adja hozzá az eltolást az értékhez:
2020-11-16T04:25:03-05:00