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.Calculates the date that is the specified number of years away from the specified date.

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.The DateTime to which to add years.

years
Int32

Nombre d’années à ajouter.The number of years to add.

Retours

DateTime

Nouveau DateTime qui résulte de l'ajout du nombre spécifié d'années au paramètre time.A new DateTime that results from adding the specified number of years 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.

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 mois du résultant DateTime reste la même que celle spécifiée DateTime .The month part of the resulting DateTime remains the same as 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, le février compte 28 jours, sauf pendant les années bissextiles, pendant 29 jours.For example, February has 28 days, except during leap years when it has 29 days. Si la date spécifiée est le vingt-neuvième jour de février dans une année bissextile et que la valeur du years paramètre est 1, la date résultante sera le vingt-huitième jour de février de l’année suivante.If the specified date is the twenty-ninth day of February in a leap year and the value of the years parameter is 1, the resulting date will be the twenty-eighth day of February in the following year.

Si years est négatif, le résultant DateTime est antérieur au spécifié DateTime .If years 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.AddYears(time, years), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind)

S’applique à