DateTimeOffset.AddMonths(Int32) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

DateTimeOffset.cs

返回一个新的 DateTimeOffset 对象，它将指定的月份数加到此实例的值上。

public:
 DateTimeOffset AddMonths(int months);

public DateTimeOffset AddMonths (int months);

member this.AddMonths : int -> DateTimeOffset

Public Function AddMonths (months As Integer) As DateTimeOffset

参数

months

Int32

整月份数。 此数值可以是负数也可以是正数。

返回

DateTimeOffset

一个对象，其值为当前的 DateTimeOffset 对象所表示的日期和时间与 months 所表示的月份数之和。

例外

ArgumentOutOfRangeException

生成的 DateTimeOffset 值小于 DateTimeOffset.MinValue。

\- 或 -

生成的 DateTimeOffset 值大于 DateTimeOffset.MaxValue。

示例

以下示例使用 AddMonths 方法显示 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

注解

与将单个时间间隔单位 (（例如分钟数或天数）添加到日期和时间值的其他大多数方法不同， AddMonths) 一个月的小数部分。 若要向 对象添加由月以外的 DateTimeOffset 其他时间单位组成的时间，请使用 Add 方法。

注意

此方法返回一个新 DateTimeOffset 对象。 它不会通过将添加到 months 当前对象的日期和时间来修改其值。