Soap.XSBuiltIns.XMLTimeToDateTime

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Soap.XSBuiltIns.pas
Soap.XSBuiltIns.hpp
Soap.XSBuiltIns Soap.XSBuiltIns

Beschreibung

Gibt einen TDateTime-Wert für einen XML-Datums-/Zeitwert zurück. Diese Funktion ist das Gegenstück zur Funktion DateTimeToXMLTime.

XMLDateTime ist ein String, der einen Datums- oder Datums-/Zeitwert im ISO 8601-Format enthält. Zum Beispiel: "2014-02-18T03:30:45+01:00". Wenn der angegebene Wert nicht richtig ist, löst XMLTimeToDateTime eine EConvertError-Exception aus: "Ist kein gültiger Datums- und Zeitwert".

AsUTCTime ist ein boolescher Wert. Wenn AsUTCTime False (Vorgabe) ist, liegt das Datum und die Uhrzeit in UTC vor, und die Zeit-Offsets ("+01:00" im obigen Beispiel) sind relativ zu UTC. Setzen Sie AsUTCTime auf True, um das Datum und die Uhrzeit als lokale Datums- und Zeitwerte zu analysieren, indem die lokale Zeitzone des Betriebssystems, auf dem Ihre Anwendung ausgeführt wird, verwendet wird und die Zeit-Offsets auf Basis der lokalen Zeitzone übernommen werden.

Wenn Sie beispielsweise in der pazifischen Zeitzone (UTC-08:00) leben:

XMLDateTime AsUTCTime Ergebnis
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

Siehe auch