EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Metodo

Definizione

Calcola la data che ricorre a una distanza pari al numero di mesi indicato a partire dalla data specificata.

public:
 override DateTime AddMonths(DateTime time, int months);
public override DateTime AddMonths (DateTime time, int months);
override this.AddMonths : DateTime * int -> DateTime
Public Overrides Function AddMonths (time As DateTime, months As Integer) As DateTime

Parametri

time
DateTime

Valore DateTime al quale aggiungere months.

months
Int32

numero di mesi da aggiungere.

Restituisce

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

Eccezioni

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

months è minore di -120000 o maggiore di 120000.

-oppure-

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 dell'anno risultante DateTime è interessata se il mese risultante non rientra nell'anno 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, se il mese specificato è ottobre, che ha 31 giorni, il giorno specificato è il trentunesimo giorno del mese e il valore del months parametro è 6, l'anno risultante è uno più dell'anno specificato, il mese risultante è Aprile e il giorno risultante è il trentesimo giorno, ovvero l'ultimo giorno di aprile.

Se il valore del months parametro è negativo, il risultato DateTime è precedente a quello 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.AddMonths(time, months), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)

Si applica a