DateTimeOffset.AddMonths(Int32) Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTimeOffset.cs

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de meses ao valor dessa instância.

public:
 DateTimeOffset AddMonths(int months);

public DateTimeOffset AddMonths (int months);

member this.AddMonths : int -> DateTimeOffset

Public Function AddMonths (months As Integer) As DateTimeOffset

Parâmetros

months

Int32

Um número de meses completos. O número pode ser positivo ou negativo.

Retornos

DateTimeOffset

Um objeto cujo valor é a soma da data e hora representada pelo objeto DateTimeOffset atual e o número de meses representado por months.

Exceções

ArgumentOutOfRangeException

O valor resultante DateTimeOffset é menor que DateTimeOffset.MinValue.

-ou-

O valor resultante DateTimeOffset é maior que DateTimeOffset.MaxValue.

Exemplos

O exemplo a seguir usa o AddMonths método para exibir a data de início de cada trimestre do ano de 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

let mutable quarterDate = DateTimeOffset(2007, 1, 1, 0, 0, 0, DateTimeOffset.Now.Offset)
for i = 1 to 4 do
    printfn $"""Quarter {i}: {quarterDate.ToString "MMMM d"}"""
    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

Comentários

Ao contrário da maioria dos outros métodos que adicionam uma única unidade de intervalo de tempo (como minutos ou dias) a um valor de data e hora, AddMonths você não permite adicionar partes fracionárias de um mês. Para adicionar um tempo que consiste em outras unidades de tempo além de meses a um DateTimeOffset objeto, use o Add método .

Observação

Este método retorna um novo objeto DateTimeOffset. Ele não modifica o valor do objeto atual adicionando months à sua data e hora.