System.DateUtils.DateToISO8601

De Appmethod Libraries
Aller à : navigation, rechercher

Object Pascal

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