EastAsianLunisolarCalendar.AddYears(DateTime, Int32) Metodo

Definizione

Spazio dei nomi:

System.Globalization

Assembly:

System.Runtime.dll

Origine:

EastAsianLunisolarCalendar.cs

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

DateTime

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

Eccezioni

ArgumentException

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

ArgumentOutOfRangeException

time è minore di MinSupportedDateTime o maggiore di MaxSupportedDateTime.

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)