System.DateUtils.ISO8601ToDate

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.DateUtils.pas
System.DateUtils.hpp
System.DateUtils System.DateUtils


Beschreibung

Konvertiert den im Format ISO 8601 angegebenen Datums-/Zeitwert AISODate in den Datums-/Zeitwert im TDateTime-Format.

  • AISODate ist ein Datums-/Zeitwert im Format ISO 8601.
  • AReturnUTC ist ein boolescher Wert, der angibt, ob der zurückgegebene Datums-/Zeitwert die Zeitverschiebung für die lokale Zeitzone des Systems, auf dem Ihre Anwendung ausgeführt wird, berücksichtigen soll. Der Vorgabewert ist True.
    • Wenn AReturnUTC True ist, berücksichtigt der resultierende Datums-/Zeitwert im Format TDateTime die Zeitverschiebung für lokale Zeitzonen nicht.
    • Wenn AReturnUTC False ist, berücksichtigt der resultierende Wert die Zeitverschiebung für die lokale Zeitzone.

Die folgende Tabelle zeigt die Verwendung von AReturnUTC. Die Eingabewerte der AISODate-Datums-/Zeitangaben liegen im ISO 8601-Format vor. Dieses Beispiel berechnet die Ergebnisse für die lokale Zeitzone (UTC+04:00).

AISODate AReturnUTC Textrepräsentation des TDateTime-Ergebnisses
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 ist hier die Zeitverschiebung für die Zeitzone (UTC-03:00) von UTC.

Siehe auch