Mise en forme des valeurs DateTime

Les valeurs de Stockage DateTime Azure doivent être représentées en tant que valeurs UTC (Temps universel coordonné). Les formats UTC sont décrits par ISO 8601.

Formats UTC ISO 8601 acceptés

Les formats UTC ISO 8601 suivants sont actuellement acceptés par Stockage Azure. La valeur de date est obligatoire, tandis que la valeur d’heure est facultative :

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

Pour la valeur de date dans ces formats, YYYY est une représentation d’année à quatre chiffres, MM est une représentation de mois à deux chiffres commençant à 1 et DD est une représentation de jour à deux chiffres commençant à 1.

Si la valeur d’heure facultative est incluse, un désignateur T littéral est nécessaire pour séparer la valeur d’heure de la valeur de date. Pour la valeur d’heure, hh est la représentation d’heure en notation 24 heures, mm est la représentation minute à deux chiffres et ss est la deuxième représentation à deux chiffres. Chacune de ces valeurs est exprimée sous forme d’entier, commençant à zéro.

Si la valeur de temps inclut des secondes, elle peut éventuellement inclure jusqu’à 7 chiffres décimaux de fractions de secondes, en suivant le modèle hh:mm:ss[.f{1,7}]. Ce modèle est pris en charge par les API, les outils et les bibliothèques clientes stockage Azure. Vous devez utiliser un point plutôt que des virgules pour délimiter la valeur fractionnaire seconde.

Si vous incluez le suffixe de fuseau horaire <TZDSuffix>facultatif , il doit être exprimé comme suit :

  • Valeur littérale Z, désignant que la valeur d’heure est exprimée en temps UTC ; ou
  • Décalage indiquant le décalage horaire par rapport à l’heure UTC. Le décalage nécessite un début + pour un décalage positif et un début - pour un décalage négatif. La valeur du décalage doit se situer entre -23:59 et +23:59.

Un exemple du format UTC combiné est illustré ci-dessous. La date est spécifiée en premier, suivie de la valeur Tlittérale , qui désigne le début de l’élément time. La valeur Z littérale à la fin de la chaîne indique que l’heure est exprimée en UTC.

La valeur date/heure du 16 novembre 2020 à 04:25:03 en heure UTC est exprimée comme suit :

2020-11-16T04:25:03Z

Pour exprimer la même heure dans l’heure standard de l’Est (EST), qui est cinq heures plus tôt qu’UTC, ajoutez le décalage à la valeur :

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

Voir aussi

Référence de l’API REST des services de stockage