EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Calcula a data que é o número de anos de distância especificado da data especificada.
public:
override DateTime AddYears(DateTime time, int years);public override DateTime AddYears (DateTime time, int years);override this.AddYears : DateTime * int -> DateTimePublic Overrides Function AddYears (time As DateTime, years As Integer) As DateTimeParâmetros
- 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.
time é menor que MinSupportedDateTime ou maior que MaxSupportedDateTime.
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);
returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind)
