System.DateUtils.ISO8601ToDate
Delphi
function ISO8601ToDate(const AISODate: string; AReturnUTC: Boolean = True): TDateTime;
C++
extern DELPHI_PACKAGE System::TDateTime __fastcall ISO8601ToDate(const System::UnicodeString AISODate, bool AReturnUTC = 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 AISODate
, spécifiée au format ISO 8601, en valeur date et heure au format TDateTime.
AISODate
est une valeur date et heure au format ISO 8601.
AReturnUTC
est un booléen définissant si la valeur date et heure renvoyée doit prendre en compte le décalage horaire relatif au fuseau horaire local du système exécutant votre application. La valeur par défaut estTrue
.
-
- Si
AReturnUTC
est défini surTrue
, la valeur date et heure résultante, au format TDateTime, ne doit pas prendre en compte le décalage horaire relatif au fuseau horaire local. - Si
AReturnUTC
est défini surFalse
, la valeur résultante prend en compte le décalage horaire relatif au fuseau horaire local.
- Si
Le tableau suivant illustre l'usage de AReturnUTC
. Les valeurs date et heure AISODate
d'entrée sont spécifiées au format ISO 8601. Cet exemple calcule les résultats pour le fuseau horaire local (UTC+04:00)
.
AISODate
|
AReturnUTC
|
Représentation texte du résultat TDateTime |
---|---|---|
2013-10-18T18:36:22.966Z
|
True
|
10/18/2013 6:36:22 PM
|
2013-10-18T18:36:22.966Z
|
False
|
10/18/2013 10:36:22 PM
|
2013-10-18T18:36:22.966-03:00
|
True
|
10/18/2013 9:36:22 PM
|
2013-10-18T18:36:22.966-03:00
|
False
|
10/19/2013 1:36:22 AM
|
-03:00
représente ici le décalage horaire pour le fuseau horaire (UTC-03:00)
de UTC.