System.DateUtils.YearsBetween

• Übergeordnet: System.DateUtils

Delphi

function YearsBetween(const ANow, AThen: TDateTime): Integer;

C++

extern DELPHI_PACKAGE int __fastcall YearsBetween(const System::TDateTime ANow, const System::TDateTime AThen);

Eigenschaften

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

Beschreibung

Gibt die Anzahl der Jahre zurück, die zwischen den beiden angegebenen TDateTime-Werten verstrichen sind.

Mit YearsBetween können Sie die Differenz zwischen zwei TDateTime-Werten in Jahren ermitteln. Da nicht alle Jahre dieselbe Länge aufweisen (Schaltjahre), gibt YearsBetween eine Näherung zurück, die auf einem Wert von 365,25 Tagen pro Jahr basiert. Es werden nur vollständige Jahre gezählt. Deshalb meldet YearsBetween beispielsweise die Differenz zwischen dem 1. Januar und dem 31. Dezember mit 0, wenn kein Schaltjahr vorliegt. Bei Schaltjahren wird dagegen der Wert 1 zurückgegeben.

YearsBetween gibt immer ein positives Ergebnis zurück und daher sind die Parameterwerte austauschbar.

Siehe auch

• YearSpan

• DaysBetween

• MilliSecondsBetween

• MinutesBetween

• HoursBetween

• SecondsBetween

• WeeksBetween

• MonthsBetween

• WithinPastYears

• Unterstützung für Datum und Uhrzeit

Codebeispiele

• DateTimeCompare (Delphi)
• DateTimeCompare (C++)