UmAlQuraCalendar.ToFourDigitYear(Int32) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將指定的年份轉換為 4 位數年份,方法是使用 TwoDigitYearMax 屬性以判斷適當的世紀。
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
參數
- year
- Int32
從 0 到 99 的 2 位數年份,或是從 1318 到 1450 的 4 位數 Um Al Qura 曆法年份。
傳回
如果 year
參數是 2 位數年份,則傳回值為對應的 4 位數年份。 如果 year
參數是 4 位數年份,則傳回值會是未變更的 year
參數。
例外狀況
year
超出此曆法所支援的範圍。
備註
方法 ToFourDigitYear 會使用 year
參數、 TwoDigitYearMax 屬性和年份來計算 4 位數年份。 此紀元取決於尋找該 100 年範圍內唯一出現的 2 位數 year
參數。 例如,如果 TwoDigitYearMax 設定為1429,則100年的範圍是從1330到1429。 因此,2 位數的 30 值會解譯為 1330,而 2 位數的 2 位數值為 29 則會解譯為 1429。
TwoDigitYearMax如果屬性是特殊值 99,ToFourDigitYear方法會忽略 控制台 中的地區和語言選項中的設定,並傳回未變更的參數year
。
ToFourDigitYear 支援兩位數年份或四位數年份。 傳遞兩位數年份值 (小於 100) 會導致 方法根據 TwoDigitYearMax 代表適當年份的值,將值轉換成四位數的值。 如果應用程式提供四位數的年份值,且該值在支援的行事歷範圍內為 ToFourDigitYear,則方法會傳回實際的輸入值。 如果應用程式提供超出支援行事曆範圍的四位數值,或提供負值,則方法會擲回例外狀況。