System.SysUtils.TryStrToTime
Delphi
function TryStrToTime(const S: string; out Value: TDateTime): Boolean;
function TryStrToTime(const S: string; out Value: TDateTime;
const AFormatSettings: TFormatSettings): Boolean;
C++
extern DELPHI_PACKAGE bool __fastcall TryStrToTime(const System::UnicodeString S, /* out */ System::TDateTime &Value)/* 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 TryStrToTime kann ein String in eine Zeitangabe zerlegt werden. Enthält S keine gültige Uhrzeit, gibt TryStrToTime False 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 TryStrToTime 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 TryStrToTime aufrufen, müssen Sie die Informationen in den Parameter AFormatSettings aufnehmen. Die landesspezifischen Standardinformationen können AFormatSettings mit TFormatSettings.Create zugewiesen werden.