System.DateUtils.NthDayOfWeek

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function NthDayOfWeek(const AValue: TDateTime): Word;

C++

extern DELPHI_PACKAGE System::Word __fastcall NthDayOfWeek(const System::TDateTime AValue);

Eigenschaften

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

Beschreibung

Gibt das Vorkommen des Wochentags zurück, das der angegebene TDateTime-repräsentiert.

NthDayOfWeek gibt für den in AValue angegebenen Datums-/Zeitwert das Vorkommen des Wochentags innerhalb des Monats zurück. Wenn AValue beispielsweise den zweiten Dienstag im Monat repräsentiert, gibt NthDayOfWeek 2 zurück.

Der Rückgabewert von NthDayOfWeek muss nicht zwangsläufig mit dem Wert übereinstimmen, den die Funktion WeekOfTheMonth zurückgibt, da NthDayOfWeek jedes Vorkommen des angegebenen Wochentags zählt. WeekOfTheMonth berücksichtigt dagegen nur Wochen, von denen mindestens vier Tage im angegebenen Monat liegen. Wenn AValue beispielsweise einen Samstag repräsentiert, der auf den Ersten des Monats fällt, gibt NthDayOfWeek den Wert 1 zurück. Der Rückgabewert von WeekOfTheMonth lautet aber in diesem Fall 5 (eventuell auch 4), da der Samstag noch zum vorhergehenden Monat zählt.

Anmerkung:  Mit der Funktion DecodeDayOfWeekInMonth können Sie das Jahr, den Monat und den Wochentag sowie das Vorkommen des Wochentags ermitteln, das der angegebene TDateTime repräsentiert.

Siehe auch

Codebeispiele