Formátování hodnot DateTime

Hodnoty služby Azure Storage DateTime musí být reprezentované jako kombinované hodnoty koordinovaného univerzálního času (UTC). Formáty UTC jsou popsány v normě ISO 8601.

Přijaté formáty ISO 8601 UTC

Azure Storage v současné době přijímá následující formáty STANDARDU ISO 8601 UTC. Hodnota data je povinná, zatímco hodnota času je volitelná:

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

Hodnota data v těchto formátech YYYY představuje čtyřmístné vyjádření roku, MM dvoumístné vyjádření měsíce začínající číslem 1 a DD dvoumístné vyjádření dne začínající číslem 1.

Pokud je zahrnuta volitelná hodnota času, je k oddělení hodnoty času od hodnoty data vyžadováno označení T literálu. Pro hodnotu hh času je hodina znázorněna v 24hodinovém zápisu, mm je dvouciferné vyjádření minuty a ss je dvouciferné druhé vyjádření. Každá z těchto hodnot je vyjádřena jako celé číslo počínaje nulou.

Pokud hodnota času zahrnuje sekundy, může volitelně obsahovat až 7 desetinných míst desetinných sekund podle vzoru hh:mm:ss[.f{1,7}]. Tento model podporují rozhraní API, nástroje a klientské knihovny služby Azure Storage. K vytyčit hodnotu zlomkové sekundy je nutné místo čárek použít tečku.

Pokud zahrnete volitelnou příponu <TZDSuffix>časového pásma , musí být vyjádřena takto:

  • Literální hodnota Zoznačující, že hodnota času je vyjádřena jako čas UTC; nebo
  • Posun označující posun času od času UTC. Posun vyžaduje pro kladný posun počáteční + hodnotu a pro záporný posun počáteční - hodnotu. Hodnota posunu musí spadat mezi -23:59 a +23:59.

Příklad kombinovaného formátu UTC je uveden níže. Jako první je zadáno datum a za ním hodnota Tliterálu , která určuje začátek časového prvku. Hodnota Z literálu na konci řetězce označuje, že čas je vyjádřen v UTC.

Hodnota data a času pro 16. listopadu 2020 v 4:25:03 v čase UTC je vyjádřena takto:

2020-11-16T04:25:03Z

Pokud chcete vyjádřit stejný čas ve východním standardním čase (EST), což je o pět hodin dříve než UTC, přidejte k hodnotě posun:

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

Viz také

Referenční informace k rozhraní REST API služby Azure Storage