EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Método
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 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
- months
- Int32
O número de meses a serem adicionados.
Um novo DateTime que resulta da adição do número especificado de meses ao parâmetro time
.
O resultante está fora do intervalo com suporte de um DateTime.
months
é menor que -120000 ou maior que 120000.
- ou -
time
é menor que MinSupportedDateTime ou maior que MaxSupportedDateTime.
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)
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 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: