DateTimeOffset.AddMonths(Int32) DateTimeOffset.AddMonths(Int32) DateTimeOffset.AddMonths(Int32) DateTimeOffset.AddMonths(Int32) Method

Definizione

Restituisce un nuovo oggetto DateTimeOffset che aggiunge il numero specificato di mesi al valore di questa istanza.Returns a new DateTimeOffset object that adds a specified number of months to the value of this instance.

public:
 DateTimeOffset AddMonths(int months);
public DateTimeOffset AddMonths (int months);
member this.AddMonths : int -> DateTimeOffset
Public Function AddMonths (months As Integer) As DateTimeOffset

Parametri

months
Int32 Int32 Int32 Int32

Numero di mesi interi.A number of whole months. Il numero può essere positivo o negativo.The number can be negative or positive.

Restituisce

Oggetto il cui valore è la somma della data e dell'ora rappresentate dall'oggetto DateTimeOffset corrente e del numero di mesi rappresentato da months.An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the number of months represented by months.

Eccezioni

Il valore DateTimeOffset risultante è minore di MinValue.The resulting DateTimeOffset value is less than MinValue.

-oppure--or- Il valore DateTimeOffset risultante è maggiore di MaxValue.The resulting DateTimeOffset value is greater than MaxValue.

Esempi

Nell'esempio seguente viene usato AddMonths il metodo per visualizzare la data di inizio di ogni trimestre dell'anno 2007.The following example uses the AddMonths method to display the start date of each quarter of the year 2007.

DateTimeOffset quarterDate = new DateTimeOffset(2007, 1, 1, 0, 0, 0, 
                                 DateTimeOffset.Now.Offset);
for (int ctr = 1; ctr <= 4; ctr++)
{
   Console.WriteLine("Quarter {0}: {1:MMMM d}", ctr, quarterDate);
   quarterDate = quarterDate.AddMonths(3);
}   
// This example produces the following output:
//       Quarter 1: January 1
//       Quarter 2: April 1
//       Quarter 3: July 1
//       Quarter 4: October 1      
Dim quarterDate As New DateTimeOffset(#01/01/2007#, DateTimeOffset.Now.Offset)
For ctr As Integer = 1 To 4
   Console.WriteLine("Quarter {0}: {1:MMMM d}", ctr, quarterDate)
   quarterDate = quarterDate.AddMonths(3)
Next   
' This example produces the following output:
'       Quarter 1: January 1
'       Quarter 2: April 1
'       Quarter 3: July 1
'       Quarter 4: October 1      

Commenti

Diversamente dalla maggior parte degli altri metodi che aggiungono una singola unità di intervallo di tempo (ad esempio minuti o giorni) a un valore di AddMonths data e ora, non consente di aggiungere parti frazionarie di un mese.Unlike most of the other methods that add a single time interval unit (such as minutes or days) to a date and time value, AddMonths does not enable you to add fractional parts of a month. Per aggiungere un'ora costituita da altre unità di tempo oltre ai mesi di un DateTimeOffset oggetto, usare il Add metodo.To add a time that consists of other time units in addition to months to a DateTimeOffset object, use the Add method.

Nota

Questo metodo restituisce un nuovo DateTimeOffset oggetto.This method returns a new DateTimeOffset object. Non modifica il valore dell'oggetto corrente aggiungendola months alla data e all'ora.It does not modify the value of the current object by adding months to its date and time.

Si applica a