System.DateUtils.DateToISO8601
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'heureADate
d'entrée est spécifiée dans le fuseau horaire UTC. La valeur par défaut estTrue
.- Si
AInputIsUTC
est défini surTrue
, la chaîne ISO 8601 résultante contient exactement la même heure queADate
, et le suffixeZ
(Zulu).- Par exemple,
35065.75
est converti en1996-01-01T18:00:00.000Z
.
- Par exemple,
- Si
AInputIsUTC
est défini surFalse
, DateToISO8601 traite l'heureADate
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.
- Si
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
.