Udostępnij za pośrednictwem


Formatowanie wartości daty/godziny

Wartości usługi Azure Storage DateTime muszą być reprezentowane jako połączone wartości uniwersalnego czasu koordynowanego (UTC). Formaty UTC są opisane przez iso 8601.

Zaakceptowane formaty ISO 8601 UTC

Następujące formaty ISO 8601 UTC są obecnie akceptowane przez usługę Azure Storage. Wartość daty jest wymagana, a wartość godziny jest opcjonalna:

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

W przypadku wartości daty w tych formatach YYYY jest czterocyfrową reprezentacją roku, MM jest dwucyfrową reprezentacją miesiąca rozpoczynającą się od 1 i DD jest dwucyfrową reprezentacją dnia rozpoczynającą się od 1.

Jeśli opcjonalna wartość godziny jest uwzględniona, do oddzielenia wartości godziny od wartości daty jest wymagany projekt literału T . Dla wartości hh czasu jest reprezentacją godziny w notacji 24-godzinnej, mm jest dwucyfrową reprezentacją minuty i ss jest dwucyfrową drugą reprezentacją. Każda z tych wartości jest wyrażona jako liczba całkowita, zaczynając od zera.

Jeśli wartość czasu zawiera sekundy, opcjonalnie może również zawierać maksymalnie 7 cyfr dziesiętnych sekund ułamkowych, zgodnie ze wzorcem hh:mm:ss[.f{1,7}]. Ten wzorzec jest obsługiwany przez interfejsy API usługi Azure Storage, narzędzia i biblioteki klienta. Należy użyć kropki, a nie przecinków, aby zdefiniować wartość ułamkowej sekundy.

Jeśli dołączysz opcjonalny sufiks <TZDSuffix>strefy czasowej , musi być wyrażony jako jeden z następujących elementów:

  • Wartość Zliterału , określająca, że wartość godziny jest wyrażona jako czas UTC; lub
  • Przesunięcie wskazujące stronniczą godzinę od czasu UTC. Przesunięcie wymaga wiodącego + przesunięcia dodatniego i wiodącego - dla ujemnego przesunięcia. Wartość przesunięcia musi należeć do zakresu od -23:59 do +23:59.

Poniżej przedstawiono przykład połączonego formatu UTC. Data jest określona najpierw, a następnie wartość Tliterału , która wyznacza początek elementu time. Wartość Z literału na końcu ciągu wskazuje, że czas jest wyrażony w formacie UTC.

Wartość daty/godziny dla 16 listopada 2020 r. o godzinie 4:25:03 czasu UTC jest wyrażona jako:

2020-11-16T04:25:03Z

Aby wyrazić ten sam czas we wschodnim czasie standardowym (EST), który wynosi pięć godzin wcześniej niż UTC, dodaj przesunięcie do wartości:

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

Zobacz też

Dokumentacja interfejsu API REST usługi Azure Storage