EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Metodo

Definizione

Calcola la data che ricorre a una distanza pari al numero di anni indicato a partire dalla data specificata.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

Parametri

time
DateTime

Valore DateTime al quale aggiungere years.The DateTime to which to add years.

years
Int32

Numero di anni da aggiungere.The number of years to add.

Restituisce

Nuovo oggetto DateTime risultante dalla somma del numero specificato di anni e del parametro time.A new DateTime that results from adding the specified number of years to the time parameter.

Eccezioni

Il risultato non è compreso nell’intervallo supportato di un oggetto DateTime.The result is outside the supported range of a DateTime.

time è minore di MinSupportedDateTime o maggiore di MaxSupportedDateTime.time is less than MinSupportedDateTime or greater than MaxSupportedDateTime.

Commenti

La parte del giorno risultante DateTime viene interessata se il giorno risultante non è un giorno valido nel mese risultante dell'anno risultante.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. In questo caso, la parte relativa al giorno viene modificata nell'ultimo giorno valido nel mese risultante dell'anno risultante.In this case, the day part is changed to the last valid day in the resulting month of the resulting year. La parte del mese dell'oggetto DateTime risultante rimane uguale all'oggetto specificato DateTime.The month part of the resulting DateTime remains the same as the specified DateTime. Questa implementazione supporta solo l'era corrente.This implementation supports only the current era. Viene pertanto generata un'eccezione se l'anno risultante non rientra nell'era dell'oggetto DateTimespecificato. ArgumentExceptionTherefore, ArgumentException is thrown if the resulting year is outside the era of the specified DateTime. La parte relativa all'ora del giorno risultante DateTime rimane uguale all'oggetto specificato. DateTimeThe time-of-day part of the resulting DateTime remains the same as the specified DateTime.

Ad esempio, febbraio ha 28 giorni, tranne che durante gli anni bisestili quando ha 29 giorni.For example, February has 28 days, except during leap years when it has 29 days. Se la data specificata è il ventinovesimo giorno di febbraio in un anno bisestile e il valore del years parametro è 1, la data risultante sarà il ventunesimo giorno di febbraio dell'anno seguente.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.

Se years è negativo, l'oggetto DateTime risultante è precedente all'oggetto DateTimespecificato.If years is negative, the resulting DateTime is earlier than the specified DateTime.

La Kind proprietà del valore restituito DateTime è sempre uguale DateTimeKind.Unspecifieda.The Kind property of the returned DateTime value always equals DateTimeKind.Unspecified. È possibile mantenere la Kind proprietà time del parametro chiamando il DateTime.SpecifyKind metodo, come illustrato nell'esempio riportato di seguito.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)

Si applica a