System.SysUtils.StrToTime
Delphi
function StrToTime(const S: string): TDateTime;
function StrToTime(const S: string;
const AFormatSettings: TFormatSettings): TDateTime;
C++
extern DELPHI_PACKAGE System::TDateTime __fastcall StrToTime(const System::UnicodeString S)/* overload */;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Description
Convertit une chaîne en valeur TDateTime.
Appelez StrToTime pour convertir une chaîne qui spécifie une heure. Si S
ne contient pas une heure valide, StrToTime déclenche une exception EConvertError.
Le paramètre S doit être composé de deux ou trois nombres séparés par le caractère défini par la variable globale TimeSeparator ou son équivalent TFormatSettings, et de manière facultative suivi par un indicateur A.M. ou P.M. Les nombres représentent l'heure, les minutes et les secondes, ces dernières étant facultatives. Si l'heure est suivie de A.M. ou P.M., le format pris en compte est celui sur 12 heures Si l'heure n'est pas suivie de A.M. ou P.M., le format pris en compte est celui sur 24 heures
La première forme de StrToTime n'est pas adaptée aux threads car elle utilise les informations de localisation contenues dans les variables globales. La seconde forme de StrToTime, qui est adaptée aux threads, fait référence aux informations de localisation contenues dans le paramètre AFormatSettings
. Avant d'appeler la forme adaptée aux threads de StrToTime, vous devez placer les informations de localisation dans AFormatSettings
. Pour placer un ensemble de valeurs locales par défaut dans AFormatSettings
, appelez TFormatSettings.Create.