System.DateUtils.DecodeDayOfWeekInMonth

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure DecodeDayOfWeekInMonth(const AValue: TDateTime; out AYear, AMonth,
ANthDayOfWeek, ADayOfWeek: Word);

C++

extern DELPHI_PACKAGE void __fastcall DecodeDayOfWeekInMonth(const System::TDateTime AValue, /* out */ System::Word &AYear, /* out */ System::Word &AMonth, /* out */ System::Word &ANthDayOfWeek, /* out */ System::Word &ADayOfWeek);

Eigenschaften

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

Beschreibung

Gibt Jahr, Monat, Wochentag und den Zähler (das Vorkommen) dieses Wochentags im Monat zu einem angegebenen TDateTime-Wert zurück.

DecodeDayOfWeekInMonth gibt zu einem angegebenen TDateTime-Wert den Wochentag und den Zähler für diesen Wochentag innerhalb des Monats zurück.

AValue ist der Datums-/Zeitwert, zu dem Informationen abgerufen werden sollen.

AYear gibt das Jahr von AValue zurück.

AMonth gibt den von AValue repräsentierten Monat zurück (1 = Januar und 12 = Dezember). ANthDayOfWeek ist der Zähler für den von AValue repräsentierten Wochentag.

ANthDayOfWeek ist der Zähler für den von AValue repräsentierten Wochentag. Wenn AValue beispielsweise den zweiten Dienstag im Monat repräsentiert, gibt ANthDayOfWeek den Wert 2 zurück. Dieser Wert muss nicht zwangsläufig mit dem Wert identisch sein, den die Funktion WeekOfTheMonth zurückgibt, da DecodeDayOfWeekInMonth 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 DecodeDayOfWeekInMonth für ANthDayOfWeek 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 gezählt wird.

ADayOfWeek gibt den Tag in der von AValue repräsentierten Woche zurück. Montag hat den Wert 1, Sonntag den Wert 7.

Anmerkung:  Die Definition für ADayOfWeek entspricht dem ISO-Standard 8601.

Tipp:  Mithilfe der Wochentagkonstanten können Sie die Aussagekraft des Rückgabewertes verbessern.

Siehe auch

Codebeispiele