System.DateUtils.TryISO8601ToDate
Delphi
function TryISO8601ToDate(const AISODate: string; out Value: TDateTime; AReturnUTC: Boolean = True): Boolean;
C++
extern DELPHI_PACKAGE bool __fastcall TryISO8601ToDate(const System::UnicodeString AISODate, /* out */ System::TDateTime &Value, bool AReturnUTC = true);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | System.DateUtils.pas System.DateUtils.hpp |
System.DateUtils | System.DateUtils |
Description
Essaie de convertir la valeur date/heure fournie, spécifiée au format ISO 8601, en valeur date/heure au format TDateTime. Renvoie True
si la conversion réussit.
AISODate
est une valeur date/heure au format ISO 8601.AReturnUTC
est un paramètre booléen optionnel qui indique si la valeur date/heure résultante doit prendre en compte les décalages horaires pour le fuseau horaire du système qui exécute votre application. La valeur par défaut estTrue
.- Si
AReturnUTC
vautTrue
, la valeur résultante ne prend pas en compte le décalage horaire à partir du 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
Value
est la variable de sortie pour la valeur date/heure résultante.
Le tableau suivant illustre l'usage de AReturnUTC
. Les valeurs date/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
|
- Remarque :
-03:00
représente le décalage horaire pour le fuseau horaireUTC-03:00
de UTC.