EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Méthode

Définition

Calcule la date qui correspond au nombre spécifié de mois à partir de la date spécifiée.Calculates the date that is the specified number of months away from the specified date.

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

Paramètres

time
DateTime

DateTime auquel ajouter months.The DateTime to which to add months.

months
Int32

Nombre de mois à ajouter.The number of months to add.

Retours

DateTime

Nouveau DateTime qui résulte de l'ajout du nombre spécifié de mois au paramètre time.A new DateTime that results from adding the specified number of months to the time parameter.

Exceptions

Le résultat ne figure pas dans la plage prise en charge d'un DateTime.The result is outside the supported range of a DateTime.

months est inférieur à -120000 ou supérieur à 120000.months is less than -120000 or greater than 120000.

- ou --or- time est inférieur à MinSupportedDateTime ou supérieur à MaxSupportedDateTime.time is less than MinSupportedDateTime or greater than MaxSupportedDateTime.

Remarques

La partie jour de la résultante DateTime est affectée si le jour résultant n’est pas un jour valide dans le mois résultant de l’année résultante.The day part of the resulting DateTime is affected if the resulting day is not a valid day in the resulting month of the resulting year. Dans ce cas, la partie jour est remplacée par le dernier jour valide du mois résultant de l’année résultante.In this case, the day part is changed to the last valid day in the resulting month of the resulting year. La partie année de la résultante DateTime est affectée si le mois résultant est en dehors de l’année du spécifié DateTime .The year part of the resulting DateTime is affected if the resulting month is outside the year of the specified DateTime. Cette implémentation prend en charge uniquement l’ère actuelle.This implementation supports only the current era. Par conséquent, ArgumentException est levé si l’année résultante est en dehors de l’ère du spécifié DateTime .Therefore, ArgumentException is thrown if the resulting year is outside the era of the specified DateTime. La partie heure de la résultante DateTime reste la même que celle spécifiée DateTime .The time-of-day part of the resulting DateTime remains the same as the specified DateTime.

Par exemple, si le mois spécifié est octobre, qui contient 31 jours, le jour spécifié est le trente-premier jour de ce mois et la valeur du months paramètre est 6, l’année résultante est une année plus grande que l’année spécifiée, le mois résultant est avril et le jour résultant est le trentième jour, qui est le dernier jour en avril.For example, if the specified month is October, which has 31 days, the specified day is the thirty-first day of that month, and the value of the months parameter is 6, the resulting year is one more than the specified year, the resulting month is April, and the resulting day is the thirtieth day, which is the last day in April.

Si la valeur du months paramètre est négative, le résultant DateTime est antérieur au spécifié DateTime .If the value of the months parameter is negative, the resulting DateTime is earlier than the specified DateTime.

La Kind propriété de la valeur retournée DateTime est toujours égale à DateTimeKind.Unspecified .The Kind property of the returned DateTime value always equals DateTimeKind.Unspecified. Vous pouvez conserver la Kind propriété du time paramètre en appelant la DateTime.SpecifyKind méthode, comme le montre l’exemple suivant.You can preserve the Kind property of the time parameter by calling the DateTime.SpecifyKind method, as the following example shows.

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

S’applique à