DateTimeOffset.AddMonths(Int32) Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

DateTimeOffset.cs

Devuelve un nuevo objeto DateTimeOffset, que agrega un número especificado de meses al valor de esta instancia.

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

Número de meses completos. El número puede ser positivo o negativo.

Devoluciones

DateTimeOffset

Un objeto cuyo valor es la suma de la fecha y hora representadas por el objeto DateTimeOffset actual y el número de meses representados por months.

Excepciones

ArgumentOutOfRangeException

El valor resultante DateTimeOffset es menor que DateTimeOffset.MinValue.

o bien

El valor resultante DateTimeOffset es mayor que DateTimeOffset.MaxValue.

Ejemplos

En el ejemplo siguiente se usa el AddMonths método para mostrar la fecha de inicio de cada trimestre del año 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

Comentarios

A diferencia de la mayoría de los otros métodos que agregan una sola unidad de intervalo de tiempo (como minutos o días) a un valor de fecha y hora, AddMonths no le permite agregar partes fraccionarias de un mes. Para agregar una hora que consta de otras unidades de tiempo además de meses a un DateTimeOffset objeto , use el Add método .

Nota

Este método devuelve un nuevo DateTimeOffset objeto . No modifica el valor del objeto actual agregando months a su fecha y hora.