System.SysUtils.StrToDate
Delphi
function StrToDate(const S: string): TDateTime;
function StrToDate(const S: string;
const AFormatSettings: TFormatSettings): TDateTime;
C++
extern DELPHI_PACKAGE System::TDateTime __fastcall StrToDate(const System::UnicodeString S)/* overload */;
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Beschreibung
Konvertiert einen String in einen Wert des Typs TDateTime.
Mit StrToDate kann ein String in eine Datumsangabe zerlegt werden. Enthält S kein gültiges Datum, löst StrToDate eine EConvertError-Exception aus.
S
muss aus zwei oder drei Zahlen bestehen, die durch das in der globalen Variablen DateSeparator bzw. deren TFormatSettings-Entsprechung angegebene Zeichen voneinander getrennt sind. Die Reihenfolge von Tag, Monat und Jahr wird von der globalen Variable ShortDateFormat bzw. deren TFormatSettings-Entsprechung bestimmt (mögliche Kombinationen sind M/T/J, T/M/J und J/M/T).
Enthält S
lediglich zwei Zahlen, wird er als Datum (M/T oder T/M) des aktuellen Jahres interpretiert.
Jahresangaben von 0 bis 99 werden mithilfe von TwoDigitYearCenturyWindow konvertiert. Dieser Wert wird entweder in einer globalen Variablen (erste Form) oder als Feld des Parameters AFormatSettings
(zweite Form) gespeichert. Weitere Informationen finden Sie unter "Formatvariablen für Währungs- und Datums-/Zeitangaben".
Die erste Form von StrToDate ist nicht Thread-sicher, da landesspezifische Informationen aus globalen Variablen verwendet werden. In der zweiten Thread-sicheren Form von StrToDate werden landesspezifische Informationen im Parameter AFormatSettings
übergeben. Vor dem Aufruf dieser Form von StrToDate müssen Sie den Parameter AFormatSettings
mit landesspezifischen Informationen füllen. Landesspezifische Standardinformationen können AFormatSettings
mit TFormatSettings.Create zugewiesen werden.