System.DateUtils.WeekOfTheYear

Übergeordnet: System.DateUtils

Delphi

function WeekOfTheYear(const AValue: TDateTime): Word;
function WeekOfTheYear(const AValue: TDateTime; var AYear: Word): Word;

C++

extern DELPHI_PACKAGE System::Word __fastcall WeekOfTheYear(const System::TDateTime AValue)/* overload */;

Inhaltsverzeichnis

1 Eigenschaften
2 Beschreibung
- 2.1 Siehe auch
- 2.2 Codebeispiele

Eigenschaften

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

Beschreibung

Gibt die Woche des Jahres zurück, das durch einen TDateTime-Wert repräsentiert wird.

Mit WeekOfTheYear können Sie die Woche des Jahres ermitteln, das durch den angegebenen TDateTime-Wert repräsentiert wird. WeekOfTheYear gibt einen Wert zwischen 1 und 53 zurück.

AYear gibt das Jahr mit der angegebenen Woche zurück. Dieser Wert darf nicht mit dem Jahr in AValue identisch sein. Der Grund liegt darin, dass die erste Woche eines Jahres als erste Woche definiert ist, von der mindestens vier Tage in das betreffende Jahr fallen. Ist also der erste Kalendertag eines Jahres der Freitag, Samstag oder Sonntag, gibt WeekOfTheYear für die ersten drei oder zwei Tage oder für den ersten Tag des Kalenderjahres die Woche des vorhergehenden Jahres zurück. Entsprechendes gilt am Jahresende: Ist der letze Kalendertag eines Jahres ein Montag, Dienstag oder Mittwoch, gibt WeekOfTheYear für die letzten drei oder zwei Tage bzw. den letzten Tag des Kalenderjahres den Wert 1 (erste Woche des nächsten Kalenderjahres) zurück.

Anmerkung: WeekOfTheYear verwendet die Wochendefinition des ISO-Standards 8601. Demzufolge beginnt eine Woche am Montag und endet mit dem Sonntag.