System.DateUtils.EncodeDateWeek

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function EncodeDateWeek(const AYear, AWeekOfYear, ADayOfWeek: Word): TDateTime;

C++

extern DELPHI_PACKAGE System::TDateTime __fastcall EncodeDateWeek(const System::Word AYear, const System::Word AWeekOfYear, const System::Word ADayOfWeek = (System::Word)(0x1));

Eigenschaften

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

Beschreibung

Gibt einen TDateTime-Wert zurück, mit dem ein angegebener Tag einer angegebenen Woche im angegebenen Jahr repräsentiert wird.

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

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

AWeekOfYear gibt die Woche im Jahr an. Der Wert 1 bezeichnet die erste Woche, die mit mehr als vier Tagen im betreffenden Jahr liegt. Ist der erste Kalendertag des Jahres ein Freitag, Samstag oder Sonntag, muss der betreffende Tag durch Einstellen des vorherigen Jahres in AYear und der Gesamtzahl der Wochen im vorhergehenden Jahr in AWeekOfYear angegeben werden. Entsprechendes gilt am Ende des Jahres: Ist der letzte Tag ein Montag, Dienstag oder Mittwoch, kann der betreffende Tag ausgedrückt werden, indem Sie für AYear das folgende Jahr und für AWeekOfYear den Wert 1 angeben.

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.

Liegt AYear nicht im gültigen Bereich, ist AWeekOfYear kleiner als 1 oder größer als die Anzahl der Wochen in AYear oder ist ADayOfWeek kleiner als 1 oder größer als 7, löst EncodeDateWeek eine EConvertError-Exception aus.

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

Siehe auch

Codebeispiele