Partilhar via


UmAlQuraCalendar.ToFourDigitYear(Int32) Método

Definição

Converte o ano especificado em um ano de quatro dígitos usando a propriedade TwoDigitYearMax para determinar o século apropriado.

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

Parâmetros

year
Int32

Um ano de 2 dígitos, de 0 a 99, ou um ano do calendário Um Al Qura de 4 dígitos, de 1318 a 1450.

Retornos

Se o parâmetro year for um ano de 2 dígitos, o valor retornado será o ano de 4 dígitos correspondente. Se o parâmetro year for um ano de 4 dígitos, o valor retornado será o parâmetro year inalterado.

Exceções

year está fora do intervalo com suporte por esse calendário.

Comentários

O ToFourDigitYear método usa o year parâmetro , a TwoDigitYearMax propriedade e um ano para calcular um ano de 4 dígitos. O século é determinado pela localização da única ocorrência do parâmetro de 2 dígitos year dentro desse intervalo de 100 anos. Por exemplo, se TwoDigitYearMax for definido como 1429, o intervalo de 100 anos será de 1330 a 1429. Portanto, um valor de 2 dígitos de 30 é interpretado como 1330, enquanto um valor de 2 dígitos de 29 é interpretado como 1429.

Se a TwoDigitYearMax propriedade for o valor especial 99, o ToFourDigitYear método ignorará as configurações nas opções regionais e de idioma em Painel de Controle e retornará o year parâmetro inalterado.

ToFourDigitYear dá suporte a um ano de dois dígitos ou a um ano de quatro dígitos. Passar um valor de ano de dois dígitos (menor que 100) faz com que o método converta o valor em um valor de quatro dígitos de acordo com o TwoDigitYearMax valor que representa o século apropriado. Se o aplicativo fornecer um valor de ano de quatro dígitos que está dentro do intervalo de calendário com suporte para ToFourDigitYear, o método retornará o valor de entrada real. Se o aplicativo fornecer um valor de quatro dígitos fora do intervalo de calendário com suporte ou se fornecer um valor negativo, o método gerará uma exceção.

Aplica-se a

Confira também