System.SysUtils.TryStrToDateTime

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function TryStrToDateTime(const S: string; out Value: TDateTime): Boolean;
function TryStrToDateTime(const S: string; out Value: TDateTime; const AFormatSettings: TFormatSettings): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall TryStrToDateTime(const System::UnicodeString S, /* out */ System::TDateTime &Value)/* 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 avec renvoi d'un code de succès booléen.

Appelez TryStrToDateTime pour convertir une chaîne qui spécifie une date et une heure. If S ne contient pas une date valide, TryStrToDateTime renvoie False.

Le paramètre S doit utiliser le format date/heure local. Aux Etats-Unis, il s'agit généralement du format MM/JJ/AA HH:MM:SS. L'indication A.M. ou P.M. pour l'heure est facultative, il en est de même pour les secondes. Utilisez un format d'heure sur 24 heures (7:45 signifiant 7:45 P.M., par exemple) si A.M. ou P.M. ne sont pas indiqués.

Les valeurs Year (année) entre 0 et 99 sont converties à l'aide de TwoDigitYearCenturyWindow. Cette valeur est stockée dans une variable globale (première forme) ou en tant que champ du paramètre AFormatSettings (seconde forme). Voir "Formatage monétaire et Date-Heure, variables" pour plus d'informations.

La première forme de TryStrToDateTime n'est pas adaptée aux threads car elle utilise les informations de localisation contenues dans les variables globales. La seconde forme de TryStrToDateTime, 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 TryStrToDateTime, vous devez placer les informations de localisation dans AFormatSettings. Pour placer un ensemble de valeurs locales par défaut dans AFormatSettings, appelez TFormatSettings.Create.

Voir aussi