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 risultante DateTime è interessata se il giorno risultante non è un giorno valido nel mese risultante dell'anno risultante. In questo caso, la parte giorno viene modificato nell'ultimo giorno valido nel mese risultante dell'anno risultante. La parte dell'anno risultante DateTime è interessata se il mese risultante è esterno all'anno dell'oggetto specificato DateTime. Questa implementazione supporta solo l'era corrente. Pertanto, ArgumentException viene generato se l'anno risultante non è all'esterno dell'era dell'oggetto specificato DateTime. La parte del giorno risultante DateTime rimane uguale a quella specificata DateTime.

Ad esempio, se il mese specificato è ottobre, che ha 31 giorni, il giorno specificato è il trentesimo giorno del mese e il valore del parametro è 6, l'anno risultante è uno più dell'anno months 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 è DateTimeKind.Unspecifiedsempre uguale a . È possibile mantenere la Kind proprietà del time parametro chiamando il metodo, come illustrato nell'esempio DateTime.SpecifyKind seguente.

returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)

Si applica a