System.DateUtils.DateToISO8601

• Aller au parent : System.DateUtils

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

• System.TDateTime
• System.DateUtils.ISO8601ToDate
• Support date et heure