UmAlQuraCalendar.ToFourDigitYear(Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.