System.DateUtils.WeekOfTheMonth

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.DateUtils.pas
System.DateUtils.hpp
System.DateUtils System.DateUtils

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.

Tipp:  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.

Siehe auch

Codebeispiele