System.DateUtils.DateToISO8601

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function DateToISO8601(const ADate: TDateTime; AInputIsUTC: Boolean = true): string;

C++

extern DELPHI_PACKAGE System::UnicodeString __fastcall DateToISO8601(const System::TDateTime ADate, bool AInputIsUTC = true);

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.DateUtils.pas
System.DateUtils.hpp
System.DateUtils System.DateUtils


Description

Convertit la valeur date et heure ADate, spécifiée au format TDateTime, en chaîne contenant une valeur date et heure au format ISO 8601.

  • ADate est une valeur date et heure au format TDateTime.
  • AInputIsUTC est un booléen définissant si l'heure ADate d'entrée est spécifiée dans le fuseau horaire UTC. La valeur par défaut est True.
    • Si AInputIsUTC est défini sur True, la chaîne ISO 8601 résultante contient exactement la même heure que ADate, et le suffixe Z (Zulu).
      Par exemple, 35065.75 est converti en 1996-01-01T18:00:00.000Z.
    • Si AInputIsUTC est défini sur False, DateToISO8601 traite l'heure ADate d'entrée comme une heure locale. L'heure au format ISO 8601 convertie contient alors le décalage horaire relatif au fuseau horaire local du système exécutant votre application.

Le tableau suivant illustre l'usage de AInputIsUTC. La valeur date et heure ADate d'entrée, spécifiée au format TDateTime, est 35065.75. Cet exemple suppose que le fuseau horaire local est (UTC-08:00) Pacific Time.

ADate AInputIsUTC Résultat ISO 8601
35065.75 True 1996-01-01T18:00:00.000Z
35065.75 False 1996-01-01T18:00:00.000-08:00

-08:00 représente ici le décalage horaire pour le fuseau horaire (UTC-08:00) Pacific Time.

Voir aussi