System.DateUtils.EncodeDateMonthWeek

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function EncodeDateMonthWeek(const AYear, AMonth, AWeekOfMonth,
ADayOfWeek: Word): TDateTime;

C++

extern DELPHI_PACKAGE System::TDateTime __fastcall EncodeDateMonthWeek(const System::Word AYear, const System::Word AMonth, const System::Word AWeekOfMonth, const System::Word ADayOfWeek);

Propriétés

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

Description

Renvoie un TDateTime qui représente un jour d'une semaine d'un mois et d'une année spécifiés.

EncodeDateMonthWeek renvoie un TDateTime pour la date spécifiée par les paramètres AYear, AMonth, AWeekOfMonth et ADayOfWeek. La partie heure de la valeur renvoyée est 0 (minuit au début du jour spécifié).

AYear représente l'année. Il peut avoir toute valeur entre 1 et 9999 (compris).

AMonth représente le mois. Il peut avoir toute valeur entre 1 et 12 (compris).

AWeekOfMonth représente la semaine dans ce mois, où 1 correspond à la première semaine d'au moins quatre jours. Si le premier jour calendaire du mois est vendredi, samedi ou dimanche, ces trois jours doivent être exprimés en attribuant à AMonth le mois précédent et à AWeekOfMonth le nombre de semaines comprises dans ce mois précédent. De même, si le dernier jour calendaire du mois est lundi, mardi ou mercredi, ces trois jours sont exprimés en attribuant à AMonth le mois suivant et à AWeekOfMonth la valeur 1.

ADayOfWeek représente le jour de la semaine : 1 pour lundi, 2 pour mardi, etc.

Conseil :  Pour faciliter la lecture de la valeur ADayOfWeek, utilisez les constantes des jours de la semaine.

Si l'un quelconque des paramètres est en dehors des limites, EncodeDateMonthWeek déclenche une exception EConvertError.

Remarque :  Les définitions de AWeekOfMonth et ADayOfWeek respectent la norme ISO 8601.

Voir aussi