Condividi tramite


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.

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.

years
Int32

numero di anni da aggiungere.

Restituisce

Nuovo oggetto DateTime risultante dalla somma del numero specificato di anni e del parametro time.

Eccezioni

Il risultato non è compreso nell’intervallo supportato di un oggetto DateTime.

Commenti

La parte del giorno dell'oggetto risultante DateTime è interessata se il giorno risultante non è un giorno valido nel mese risultante dell'anno risultante. In questo caso, la parte del giorno viene modificata nell'ultimo giorno valido nel mese risultante dell'anno risultante. La parte mensile dell'oggetto risultante DateTime rimane invariata dell'oggetto specificato DateTime. Questa implementazione supporta solo l'era corrente. ArgumentException Viene pertanto generata se l'anno risultante non rientra nell'era dell'oggetto specificatoDateTime. La parte relativa all'ora del giorno risultante DateTime rimane la stessa dell'oggetto specificato DateTime.

Ad esempio, febbraio ha 28 giorni, tranne durante gli anni intercalare quando ha 29 giorni. Se la data specificata è il ventunesimo giorno di febbraio in un anno bisestile e il valore del years parametro è 1, la data risultante sarà il ventunesimo giorno di febbraio nell'anno successivo.

Se years è negativo, l'oggetto risultante DateTime è precedente all'oggetto specificato DateTime.

La Kind proprietà del valore restituito DateTime è sempre uguale a DateTimeKind.Unspecified. È possibile mantenere la Kind proprietà del time parametro chiamando il DateTime.SpecifyKind metodo , come illustrato nell'esempio seguente.

returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind)

Si applica a