System.DateUtils.TryISO8601ToDate

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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

Eigenschaften

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


Beschreibung

Versucht, den im ISO 8601-Format angegebenen Datums-/Zeitwert in einen Datums-/Zeitwert im Format TDateTime zu konvertieren. Gibt True zurück, wenn die Konvertierung erfolgreich war.

  • AISODate ist ein Datums-/Zeitwert im ISO 8601-Format.
  • AReturnUTC ist ein optionaler boolescher Parameter, der angibt, ob der resultierende Datums-/Zeitwert die Zeit-Offsets (EN) für die lokale Zeitzone des Systems, auf dem die Anwendung ausgeführt wird, berücksichtigen soll. Der Vorgabewert ist True.
    • Wenn AReturnUTC True ist, berücksichtigt der resultierende Wert die Zeitverschiebung für die lokale Zeitzone nicht.
    • Wenn AReturnUTC False ist, berücksichtigt der resultierende Wert die Zeitverschiebung für die lokale Zeitzone.
  • Value ist die Ausgabevariable für den resultierenden Datums-/Zeitwert.

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
Hinweis: -03:00 ist hier die Zeitverschiebung für die Zeitzone UTC-03:00 von UTC.

Siehe auch