System.DateUtils.ISO8601ToDate

De RAD Studio API Documentation
Aller à : navigation, rechercher

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 est True.
    • Si AReturnUTC est défini sur True, 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 sur False, la valeur résultante prend en compte le décalage horaire relatif au fuseau horaire local.

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.

Voir aussi