System.SysUtils.StrToDateDef
Delphi
function StrToDateDef(const S: string; const Default: TDateTime): TDateTime;
function StrToDateDef(const S: string; const Default: TDateTime; const AFormatSettings: TFormatSettings): TDateTime;
C++
extern DELPHI_PACKAGE System::TDateTime __fastcall StrToDateDef(const System::UnicodeString S, const System::TDateTime Default)/* overload */;
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. Dabei gelten Voreinstellungen für den Fehlerfall.
Mit StrToDateDef kann ein String in eine Datumsangabe zerlegt werden. Enthält S
kein gültiges Datum, gibt StrToDateDef Default
zurück.
Der String S
muss aus zwei oder drei Zahlen bestehen, die durch das in der globalen Variable DateSeparator bzw. deren TFormatSettings-Entsprechung definierte 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 der String S
lediglich zwei Zahlen, wird er als Datum (M/T oder T/M) des aktuellen Jahres interpretiert.
Jahresangaben zwischen 0 und 99 werden mithilfe der globalen Variablen 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 Datums-/Zeitangaben".
Die erste Form von StrToDateDef ist nicht Thread-sicher, da die landesspezifischen Informationen der globalen Variablen verwendet werden. Der Thread-sicheren zweiten Form werden die landesspezifischen Informationen im Parameter AFormatSettings
übergeben. Bevor Sie diese Form von StrToDateDef aufrufen, müssen Sie die Informationen in den Parameter AFormatSettings
aufnehmen. Die landesspezifischen Standardinformationen können FormatSettings mit TFormatSettings.Create zugewiesen werden.