EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> DateTimePublic Overrides Function AddMonths (time As DateTime, months As Integer) As DateTimeParamètres
- 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)
