EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Método

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Origem:

EastAsianLunisolarCalendar.cs

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

public:
 override DateTime AddMonths(DateTime time, int months);

public override DateTime AddMonths (DateTime time, int months);

override this.AddMonths : DateTime * int -> DateTime

Public Overrides Function AddMonths (time As DateTime, months As Integer) As DateTime

Parâmetros

time

DateTime

O DateTime ao qual adicionar months.

months

Int32

O número de meses a serem adicionados.

Retornos

DateTime

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

Exceções

ArgumentException

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

ArgumentOutOfRangeException

months é menor que -120000 ou maior que 120000.

- ou -

time é menor que MinSupportedDateTime ou maior que MaxSupportedDateTime.

Comentários

A parte do dia do resultante 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 ano do resultante DateTime será afetada se o mês resultante estiver fora do ano do especificado 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 da hora do dia do resultante DateTime permanece a mesma que a especificada DateTime.

Por exemplo, se o mês especificado for outubro, que tem 31 dias, o dia especificado for o trinta primeiro dia desse mês e o valor do months parâmetro for 6, o ano resultante será um a mais do que o ano especificado, o mês resultante será abril e o dia resultante será o trigésimo dia, que é o último dia de abril.

Se o valor do months parâmetro 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.AddMonths(time, months), time.Kind);

returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)