System.DateUtils.TryISO8601ToDate

De RAD Studio API Documentation
Aller à : navigation, rechercher

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 est True.
    • Si AReturnUTC vaut True, la valeur résultante ne prend pas en compte le décalage horaire à partir du 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.
  • 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 horaire UTC-03:00 de UTC.

Voir aussi