Soap.XSBuiltIns.XMLTimeToDateTime

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function XMLTimeToDateTime(const XMLDateTime: InvString; AsUTCTime: Boolean = False): TDateTime;

C++

extern DELPHI_PACKAGE System::TDateTime __fastcall XMLTimeToDateTime(const System::UnicodeString XMLDateTime, bool AsUTCTime = false);

Propriétés

Type Visibilité  Source Unité  Parent
function public
Soap.XSBuiltIns.pas
Soap.XSBuiltIns.hpp
Soap.XSBuiltIns Soap.XSBuiltIns


Description

Renvoie une valeur TDateTime pour une valeur date et heure XML. Cette fonction est l'inverse de la fonction DateTimeToXMLTime.

XMLDateTime est une chaîne ayant une date ou une date et une heure au format ISO 8601. Par exemple : "2014-02-18T03:30:45+01:00". Si la valeur spécifiée n'est pas correcte, XMLTimeToDateTime déclenche une exception EConvertError : "Ne correspond pas à une date et une heure correctes".

AsUTCTime est une valeur booléenne. Si AsUTCTime vaut False (par défaut), la date et l'heure sont au format UTC, et les décalages de fuseau horaire ("+01:00" dans l'exemple ci-dessus) sont exprimés relativement au temps universel (UTC). Définissez AsUTCTime sur True pour que la date et l'heure soient traitées comme la date et l'heure locales, en utilisant le fuseau horaire local du système sur lequel votre application fonctionne, et en appliquant également les décalages de fuseau horaire en fonction du fuseau horaire local.

Ainsi, si vous habitez dans la zone Heure standard du Pacifique (UTC-08:00) :

XMLDateTime AsUTCTime Résultat
2015-04-03T20:00:00 False 2015-04-03 12:00:00
2015-04-03T20:00:00 True 2015-04-03 20:00:00
2015-04-03T20:00:00+01:00 False 2015-04-03 11:00:00
2015-04-03T20:00:00+01:00 True 2015-04-03 19:00:00

Voir aussi