EastAsianLunisolarCalendar.AddMonths(DateTime, Int32) Method

Definition

Calcola la data che ricorre a una distanza pari al numero di mesi indicato a partire dalla data specificata.Calculates the date that is the specified number of months away from the specified date.

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

Parameters

time
DateTime

Valore DateTime al quale aggiungere months.The DateTime to which to add months.

months
Int32

Numero di mesi da aggiungere.The number of months to add.

Returns

DateTime

Nuovo oggetto DateTime risultante dalla somma del numero specificato di mesi e del parametro time.A new DateTime that results from adding the specified number of months to the time parameter.

Exceptions

Il risultato non è compreso nell’intervallo supportato di un oggetto DateTime.The result is outside the supported range of a DateTime.

months è minore di -120000 o maggiore di 120000.months is less than -120000 or greater than 120000.

-oppure--or- time è minore di MinSupportedDateTime o maggiore di MaxSupportedDateTime.time is less than MinSupportedDateTime or greater than MaxSupportedDateTime.

Remarks

La parte relativa al giorno dell'DateTime risultante viene interessata se il giorno risultante non è un giorno valido nel mese risultante dell'anno risultante.The day part of the resulting DateTime is affected if the resulting day is not a valid day in the resulting month of the resulting year. In questo caso, la parte relativa al giorno viene modificata nell'ultimo giorno valido nel mese risultante dell'anno risultante.In this case, the day part is changed to the last valid day in the resulting month of the resulting year. Se il mese risultante non rientra nell'anno della DateTimespecificata, viene interessata la parte dell'anno risultante del DateTime risultante.The year part of the resulting DateTime is affected if the resulting month is outside the year of the specified DateTime. Questa implementazione supporta solo l'era corrente.This implementation supports only the current era. Pertanto, ArgumentException viene generata se l'anno risultante non rientra nell'era del DateTimespecificato.Therefore, ArgumentException is thrown if the resulting year is outside the era of the specified DateTime. La parte relativa all'ora del DateTime risultante rimane identica alla DateTimespecificata.The time-of-day part of the resulting DateTime remains the same as the specified DateTime.

Se, ad esempio, il mese specificato è ottobre, che include 31 giorni, il giorno specificato è il 30 ° giorno del mese e il valore del parametro months è 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.For example, if the specified month is October, which has 31 days, the specified day is the thirty-first day of that month, and the value of the months parameter is 6, the resulting year is one more than the specified year, the resulting month is April, and the resulting day is the thirtieth day, which is the last day in April.

Se il valore del parametro months è negativo, il DateTime risultante è precedente al DateTimespecificato.If the value of the months parameter is negative, the resulting DateTime is earlier than the specified DateTime.

La proprietà Kind del valore DateTime restituito è sempre uguale a DateTimeKind.Unspecified.The Kind property of the returned DateTime value always equals DateTimeKind.Unspecified. È possibile mantenere la proprietà Kind del parametro time chiamando il metodo DateTime.SpecifyKind, come illustrato nell'esempio riportato di seguito.You can preserve the Kind property of the time parameter by calling the DateTime.SpecifyKind method, as the following example shows.

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

Applies to