EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Método

Definição

Calcula a data que é o número de anos de distância especificado da data especificada.

public override DateTime AddYears (DateTime time, int years);

Parâmetros

time
DateTime

O DateTime ao qual adicionar years.

years
Int32

O número de anos a ser adicionado.

Retornos

Um novo DateTime que resulta da adição do número especificado de anos ao parâmetro time.

Exceções

O resultante está fora do intervalo com suporte de um DateTime.

Comentários

A parte do dia do resultado DateTime será afetada se o dia resultante não for um dia válido no mês resultante do ano resultante. Nesse caso, a parte do dia é alterada para o último dia válido no mês resultante do ano resultante. A parte do mês do resultado DateTime permanece a mesma que a especificada DateTime. Essa implementação dá suporte apenas à era atual. Portanto, ArgumentException será gerado se o ano resultante estiver fora da era do especificado DateTime. A parte de hora do dia do resultado DateTime permanece a mesma que a especificada DateTime.

Por exemplo, fevereiro tem 28 dias, exceto durante os anos bissextos, quando tem 29 dias. Se a data especificada for o vigésimo nono dia de fevereiro em um ano bissexto e o valor do years parâmetro for 1, a data resultante será o vigésimo oitavo dia de fevereiro no ano seguinte.

Se years for negativo, o resultado DateTime será anterior ao especificado DateTime.

A Kind propriedade do valor retornado DateTime sempre é DateTimeKind.Unspecifiedigual a . Você pode preservar a Kind propriedade do time parâmetro chamando o DateTime.SpecifyKind método , como mostra o exemplo a seguir.

returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind);

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0