UmAlQuraCalendar.ToFourDigitYear(Int32) Methode

Definition

Konvertiert das angegebene Jahr in eine vierstellige Jahresangabe, indem anhand der TwoDigitYearMax-Eigenschaft das entsprechende Jahrhundert bestimmt wird.

public:
 override int ToFourDigitYear(int year);
public override int ToFourDigitYear (int year);
override this.ToFourDigitYear : int -> int
Public Overrides Function ToFourDigitYear (year As Integer) As Integer

Parameter

year
Int32

Eine zweistellige Jahresangabe zwischen 0 und 99 oder eine vierstellige Jahresangabe aus dem Umm-al-Qura-Kalender zwischen 1318 und 1450.

Gibt zurück

Wenn der year-Parameter eine zweistellige Jahresangabe ist, ist der Rückgabewert die entsprechende vierstellige Jahresangabe. Wenn der year-Parameter eine vierstellige Jahresangabe ist, ist der Rückgabewert der unveränderteyear-Parameter.

Ausnahmen

year liegt außerhalb des Bereichs, der von diesem Kalender unterstützt wird.

Hinweise

Die ToFourDigitYear Methode verwendet den year Parameter, die TwoDigitYearMax Eigenschaft und ein Jahr, um ein 4-stelliges Jahr zu berechnen. Das Jahrhundert wird bestimmt, indem das einzige Vorkommen des 2-stelligen year Parameters innerhalb dieses 100-Jahres-Bereichs ermittelt wird. Wenn TwoDigitYearMax beispielsweise auf 1429 festgelegt ist, liegt der 100-Jahres-Bereich zwischen 1330 und 1429. Daher wird ein 2-stelliger Wert von 30 als 1330 interpretiert, während ein 2-stelliger Wert von 29 als 1429 interpretiert wird.

Wenn die TwoDigitYearMax -Eigenschaft der sondere Wert 99 ist, ignoriert die ToFourDigitYear Methode die Einstellungen in den Regions- und Sprachoptionen in Systemsteuerung und gibt den year Parameter unverändert zurück.

ToFourDigitYear unterstützt entweder ein zweistelliges Jahr oder ein vierstelliges Jahr. Durch das Übergeben eines zweistelligen Jahreswerts (kleiner als 100) konvertiert die Methode den Wert in einen vierstelligen Wert gemäß dem Wert, der TwoDigitYearMax das entsprechende Jahrhundert darstellt. Wenn die Anwendung einen vierstelligen Jahreswert innerhalb des unterstützten Kalenderbereichs an ToFourDigitYearbereitstellt, gibt die Methode den tatsächlichen Eingabewert zurück. Wenn die Anwendung einen vierstelligen Wert außerhalb des unterstützten Kalenderbereichs oder einen negativen Wert bereitstellt, löst die Methode eine Ausnahme aus.

Gilt für:

Weitere Informationen