System.SysUtils.StrToTimeDef
Delphi
function StrToTimeDef(const S: string; const Default: TDateTime): TDateTime;
function StrToTimeDef(const S: string; const Default: TDateTime; const AFormatSettings: TFormatSettings): TDateTime;
C++
extern DELPHI_PACKAGE System::TDateTime __fastcall StrToTimeDef(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 StrToTimeDef kann ein String in eine Zeitangabe zerlegt werden. Enthält S
keine gültige Uhrzeit, gibt StrToTimeDef Default
zurück.
Der Parameter S
muss aus zwei oder drei Zahlen bestehen, die durch das in der globalen Variablen TimeSeparator bzw. deren TFormatSettings-Entsprechung angegebene Zeichen voneinander getrennt sind. Optional kann danach noch die Angabe AM oder PM folgen. Die Zahlen entsprechen den Stunden, Minuten und (optional) Sekunden. Werden nach der Zeitangabe die Zeichen AM oder PM angegebenen, wird von einem 12-Stunden-Zeitformat ausgegangen. Für das in Europa gebräuchliche 24-Stunden-Format braucht AM oder PM nicht angegeben zu werden.
Die erste Form von StrToTimeDef 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 StrToTimeDef aufrufen, müssen Sie die Informationen in den Parameter AFormatSettings
aufnehmen. Die landesspezifischen Standardinformationen können AFormatSettings
mit TFormatSettings.Create zugewiesen werden.