System.DateUtils.TryRecodeDateTime

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function TryRecodeDateTime(const AValue: TDateTime; const AYear, AMonth, ADay, AHour, AMinute, ASecond, AMilliSecond: Word; out AResult: TDateTime): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall TryRecodeDateTime(const System::TDateTime AValue, const System::Word AYear, const System::Word AMonth, const System::Word ADay, const System::Word AHour, const System::Word AMinute, const System::Word ASecond, const System::Word AMilliSecond, /* out */ System::TDateTime &AResult);

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.DateUtils.pas
System.DateUtils.hpp
System.DateUtils System.DateUtils

Description

Remplace de façon sélective les parties d'une valeur TDateTime spécifiée.

Appelez TryRecodeDateTime pour convertir la valeur date/heure spécifiée par AValue à partir de la valeur issue de l'affectation de AYear à l'année, de AMonth au mois, de ADay au jour du mois, de AHour à l'heure, de AMinute à la minute, de ASecond à la seconde et de AMilliSecond à la milliseconde. Vous pouvez affecter à chacun de ces paramètres la valeur RecodeLeaveFieldAsIs afin que TryRecodeDateTime conserve la partie existante de la valeur TDateTime.

La valeur de AYear peut aller de 1 à 9999 (ou être RecodeLeaveFieldAsIs).

La valeur de AMonth peut aller de 1 à 12 (ou être RecodeLeaveFieldAsIs).

Les valeurs légales de ADay dépendent du mois représenté par AMonth. (Par exemple, si AMonth a pour valeur 1, les valeurs admises pour ADay vont de 1 à 31 ; si AMonth a pour valeur 2, les valeurs admises pour ADay vont de 1 à 28 ou de 1 à 29, suivant l'année ; etc.) ADay peut également avoir pour valeur RecodeLeaveFieldAsIs.

La valeur de AHour peut aller de 0 à 24 (ou être RecodeLeaveFieldAsIs). Si AHour a pour valeur 24, AMinute, ASecond et AMilliSecond doivent tous avoir pour valeur 0.

La valeur de AMinute peut aller de 0 à 59 (ou être RecodeLeaveFieldAsIs).

La valeur de ASecond peut aller de 0 à 59 (ou être RecodeLeaveFieldAsIs).

La valeur de AMilliSecond peut aller de 0 à 999 (ou être RecodeLeaveFieldAsIs).

La valeur issue de AResult provient des modifications spécifiées apportées à AValue.

TryRecodeDateTime renvoie true si tous les paramètres respectent leur plage respective, false sinon.

Voir aussi