EastAsianLunisolarCalendar.AddYears(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é d'années à partir de la date spécifiée.
public:
override DateTime AddYears(DateTime time, int years);public override DateTime AddYears (DateTime time, int years);override this.AddYears : DateTime * int -> DateTimePublic Overrides Function AddYears (time As DateTime, years As Integer) As DateTimeParamètres
- years
- Int32
Nombre d’années à ajouter.
Retours
Nouveau DateTime qui résulte de l'ajout du nombre spécifié d'années au paramètre time.
Exceptions
Le résultat ne figure pas dans la plage prise en charge d'un DateTime.
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 mensuelle du résultat DateTime reste identique à celle spécifiée 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 heure de la journée du résultat DateTime reste la même que celle spécifiée DateTime.
Par exemple, février a 28 jours, sauf pendant les années bissextiles où il a 29 jours. Si la date spécifiée est le vingt-neuvième jour de février d’une année bissextile et que la valeur du years paramètre est 1, la date résultante est le vingt-huitième jour de février de l’année suivante.
Si years est négatif, le résultat DateTime est 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.AddYears(time, years), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind)
