UmAlQuraCalendar.ToFourDigitYear(Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Konwertuje określony rok na czterocyfrowy rok przy użyciu właściwości w TwoDigitYearMax celu określenia odpowiedniego wieku.
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
Parametry
- year
- Int32
2-cyfrowy rok od 0 do 99 lub 4-cyfrowy rok kalendarzowy Um Al Qura od 1318 do 1450.
Zwraca
year
Jeśli parametr jest 2-cyfrowym rokiem, zwracana wartość to odpowiadający 4-cyfrowy rok. year
Jeśli parametr jest 4-cyfrowym rokiem, wartość zwracana jest niezmienionym year
parametrem.
Wyjątki
year
znajduje się poza zakresem obsługiwanym przez ten kalendarz.
Uwagi
Metoda ToFourDigitYear używa parametru year
, TwoDigitYearMax właściwości i roku do obliczenia 4-cyfrowego roku. Wiek jest określany przez znalezienie jedynego wystąpienia 2-cyfrowego year
parametru w tym zakresie 100-letnim. Jeśli na przykład TwoDigitYearMax ustawiono wartość 1429, zakres 100 lat wynosi od 1330 do 1429. W związku z tym wartość 2-cyfrowa 30 jest interpretowana jako 1330, podczas gdy wartość 2-cyfrowa 29 jest interpretowana jako 1429.
TwoDigitYearMax Jeśli właściwość jest wartością specjalną 99, ToFourDigitYear metoda ignoruje ustawienia w opcjach regionalnych i językowych w Panel sterowania i zwraca year
parametr bez zmian.
ToFourDigitYear obsługuje dwucyfrowy rok lub czterocyfrowy rok. Przekazanie dwucyfrowej wartości roku (mniejszej niż 100) powoduje, że metoda konwertuje wartość na wartość czterocyfrową zgodnie z TwoDigitYearMax wartością reprezentującą odpowiedni wiek. Jeśli aplikacja dostarcza czterocyfrową wartość roku, która znajduje się w obsługiwanym zakresie kalendarza do ToFourDigitYear, metoda zwraca rzeczywistą wartość wejściową. Jeśli aplikacja dostarcza czterocyfrową wartość, która znajduje się poza obsługiwanym zakresem kalendarza lub jeśli dostarcza wartość ujemną, metoda zgłasza wyjątek.