System.DateUtils.EncodeDateMonthWeek

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function EncodeDateMonthWeek(const AYear, AMonth, AWeekOfMonth,
ADayOfWeek: Word): TDateTime;

C++

extern DELPHI_PACKAGE System::TDateTime __fastcall EncodeDateMonthWeek(const System::Word AYear, const System::Word AMonth, const System::Word AWeekOfMonth, const System::Word ADayOfWeek);

Eigenschaften

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

Beschreibung

Gibt den TDateTime-Wert zurück, der einen bestimmten Tag, eine bestimmte Woche, einen bestimmten Monat und ein bestimmtes Jahr darstellt.

EncodeDateMonthWeek gibt einen TDateTime-Wert für das mit den Parametern AYear, AMonth, AWeekOfMonth und ADayOfWeek angegebene Datum zurück. Der Zeitanteil des Rückgabewertes ist 0 (Mitternacht des angegebenen Tages).

AYear ist das Jahr. Zulässig sind Werte zwischen 1 und 9999 (inklusive).

AMonth gibt den Monat an. Zulässig sind Werte zwischen 1 und 12 (inklusive).

AWeekOfMonth ist die Woche im Monat. Woche 1 ist die erste Woche mit vier oder mehr Tagen im betreffenden Monat. Ist der erste Kalendertag des Monats ein Freitag, Samstag oder Sonntag, muss der betreffende Tag durch Übergeben des vorherigen Monats in AMonth und der Gesamtzahl der Wochen im vorhergehenden Monat in AWeekOfMonth angegeben werden. Entsprechendes gilt am Monatsende. Ist der letzte Tag des Monats ein Montag, Dienstag oder Mittwoch, geben Sie für AMonth den Folgemonat und für AWeekOfMonth den Wert 1 an.

ADayOfWeek ist der Wochentag (1 für Montag, 2 für Dienstag usw.).

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

Wenn einer der Parameter nicht im gültigen Bereich liegt, löst EncodeDateMonthWeek eine EConvertError-Exception aus.

Anmerkung:  Die Definitionen für AWeekOfMonth und ADayOfWeek entsprechen dem ISO-Standard 8601.

Siehe auch

Codebeispiele