System.DateUtils.WeekOfTheMonth
Delphi
function WeekOfTheMonth(const AValue: TDateTime): Word;
function WeekOfTheMonth(const AValue: TDateTime; var AYear, AMonth: Word): Word;
C++
extern DELPHI_PACKAGE System::Word __fastcall WeekOfTheMonth(const System::TDateTime AValue)/* overload */;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | System.DateUtils.pas System.DateUtils.hpp |
System.DateUtils | System.DateUtils |
Description
Renvoie la semaine du mois représenté par une valeur TDateTime.
Appelez WeekOfTheMonth pour obtenir la semaine du mois représenté par une valeur TDateTime spécifiée. WeekOfTheMonth renvoie une valeur comprise entre 1 et 6.
AYear et AMonth renvoient l'année et le mois dans lesquels WeekOfTheMonth tombe. Ces valeurs peuvent différer de l'année et du mois de AValue. En effet, la première semaine d'un mois est la première qui contient au moins quatre jours dans ce mois. Par conséquent, si le premier jour du mois est vendredi, samedi ou dimanche, le premier, les deux premiers ou les trois premiers jours du mois appartiennent à la dernière semaine du mois antérieur. De même, si le dernier jour du mois est lundi, mardi ou mercredi, le dernier, les deux derniers ou les trois derniers jours du mois appartiennent à la première semaine du mois suivant.
Conseil : Pour compter des semaines basées sur le jour de la semaine de la valeur date et heure, utilisez plutôt la fonction NthDayOfWeek. Par exemple, si AValue représente un samedi qui est le premier jour du mois, WeekOfTheMonth renvoie 5 (ou bien 4), en indiquant la dernière semaine du mois précédent, tandis que NthDayOfWeek renvoie 1 lorsque AValue est le premier samedi du mois.
Remarque : WeekOfTheMonth définit la semaine d'après la norme ISO 8601. La semaine commence le lundi et s'achève le dimanche.