Partager via


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.

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.

months
Int32

Nombre de mois à ajouter.

Retours

Nouveau DateTime qui résulte de l'ajout du nombre spécifié de mois au paramètre time.

Exceptions

Le résultat ne figure pas dans la plage prise en charge d'un DateTime.

months est inférieur à -120000 ou supérieur à 120000.

-ou-

time est inférieur à MinSupportedDateTime ou supérieur à MaxSupportedDateTime.

Remarques

La partie jour du résultat 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. Dans ce cas, la partie jour est remplacée par le dernier jour valide du mois résultant de l’année résultante. La partie année du résultat DateTime est affectée si le mois résultant est en dehors de l’année du spécifié DateTime. Cette implémentation prend uniquement en charge l’ère actuelle. Par conséquent, ArgumentException est levée si l’année résultante est en dehors de l’ère du spécifié DateTime. La partie de l’heure du résultat DateTime reste la même que celle spécifiée DateTime.

Par exemple, si le mois spécifié est Octobre, qui a 31 jours, le jour spécifié est le trente et unième jour de ce mois et la valeur du months paramètre est 6, l’année résultante est une de plus 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 d’avril.

Si la valeur du months paramètre est négative, le résultat est DateTime antérieur au spécifié DateTime.

La Kind propriété de la valeur retournée DateTime est DateTimeKind.Unspecifiedtoujours égale à . Vous pouvez conserver la Kind propriété du paramètre en time appelant la DateTime.SpecifyKind méthode , comme le montre l’exemple suivant.

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

S’applique à