EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> DateTimePublic Overrides Function AddMonths (time As DateTime, months As Integer) As DateTimeParametri
- 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)
