Partager via


EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Méthode

Définition

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 -> DateTime
Public Overrides Function AddYears (time As DateTime, years As Integer) As DateTime

Paramètres

time
DateTime

DateTime auquel ajouter years.

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)

S’applique à