System.DateUtils.EncodeDateWeek

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function EncodeDateWeek(const AYear, AWeekOfYear, ADayOfWeek: Word): TDateTime;

C++

extern DELPHI_PACKAGE System::TDateTime __fastcall EncodeDateWeek(const System::Word AYear, const System::Word AWeekOfYear, const System::Word ADayOfWeek = (System::Word)(0x1));

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'une année spécifiés.

EncodeDateWeek renvoie un TDateTime pour la date spécifiée par les paramètres AYear, AWeekOfYear 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).

AWeekOfYear représente la semaine dans cette année, où 1 correspond à la première semaine d'au moins quatre jours. Si le premier jour calendaire de l'année est vendredi, samedi ou dimanche, ces trois jours doivent être exprimés en attribuant à AYear l'année antérieure et à AWeekOfYear le nombre de semaines comprises dans cette année antérieure. De même, si le dernier jour calendaire de l'année est lundi, mardi ou mercredi, ces trois jours sont exprimés en attribuant à AYear l'année suivante et à AWeekOfYear 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 la valeur de AYear est en dehors des limites, AWeekOfYear est inférieur à 1 ou supérieur au nombre de semaines dans AYear ou ADayOfWeek est inférieur à 1 ou supérieur à 7, EncodeDateWeek déclenche une exception EConvertError.

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

Voir aussi