DateUtils.WeekOfTheMonth

Delphi-Informationen

von DateUtils.pas

	function WeekOfTheMonth(const AValue: TDateTime): Word; overload;
 
	function WeekOfTheMonth(const AValue: TDateTime;
		var AYear: Word;
		var AMonth: Word): Word; overload;

Unit: DateUtils

Typ: Funktion

Sichtbarkeit: public

C++-Informationen

von DateUtils.hpp

	unsigned short __fastcall WeekOfTheMonth(System::TDateTime AValue);

Unit: DateUtils

Typ: Funktion

Beschreibung

Gibt die Woche des Monats zurück, der durch einen TDateTime-Wert repräsentiert wird.

Mit WeekOfTheMonth können Sie die Woche des Monats ermitteln, der durch den angegebenen TDateTime-Wert repräsentiert wird. WeekOfTheMonth gibt einen Wert zwischen 1 und 6 zurück.

AYear und AMonth geben das Jahr und den Monat zurück. Diese Werte dürfen nicht mit Monat und Jahr in AValue identisch sein. Der Grund liegt darin, dass die erste Woche eines Monats als erste Woche definiert ist, von der mindestens vier Tage in den betreffenden Monat fallen. Ist der erste Tag des Monats also ein Freitag, Samstag oder Sonntag, gehören die ersten drei oder zwei Tage bzw. gehört der erste Tag des Monats definitionsgemäß zur letzten Woche des Vormonats. Entsprechendes gilt am Monatsende: Ist der letzte Tag des Monats ein Montag, Dienstag oder Mittwoch, gehören die letzten drei oder zwei Tage bzw. gehört der letzte Tag des Monats definitionsgemäß zur ersten Woche des Folgemonats.

Tip: Mit der Funktion NthDayOfWeek können Sie die Woche basierend auf dem Wochentag ermitteln, der im Datums-/Zeitwert angegeben ist. Wenn AValue beispielsweise einen Samstag repräsentiert, der auf den Ersten des Monats fällt, gibt WeekOfTheMonth den Wert 5 (eventuell auch 4) zurück, da der Samstag noch zum vorhergehenden Monat zählt. Der Rückgabewert von NthDayOfWeek lautet in diesem Fall 1.

Anmerkung: WeekOfTheMonth verwendet die Wochendefinition des ISO-Standards 8601. Demzufolge beginnt eine Woche am Montag und endet mit dem Sonntag.