UmAlQuraCalendar.ToFourDigitYear(Int32) Metoda

Definicja

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

Int32

year Jeśli parametr jest 2-cyfrowym rokiem, zwracana wartość jest odpowiednia 4-cyfrowy rok. year Jeśli parametr jest 4-cyfrowym rokiem, zwracana wartość 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 100-letnim zakresie. Jeśli na przykład TwoDigitYearMax ustawiono wartość 1429, zakres 100 lat wynosi od 1330 do 1429. W związku z tym 2-cyfrowa wartość 30 jest interpretowana jako 1330, podczas gdy 2-cyfrowa wartość 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.

Dotyczy

Zobacz też