This documentation is archived and is not being maintained.

DateTime.AddMonths Method

Adds the specified number of months to the value of this instance.

[Visual Basic]
Public Function AddMonths( _
   ByVal months As Integer _
) As DateTime
public DateTime AddMonths(
 int months
public: DateTime AddMonths(
 int months
public function AddMonths(
   months : int
) : DateTime;


A number of months. The months parameter can be negative or positive.

Return Value

A DateTime whose value is the sum of the date and time represented by this instance and months.


Exception Type Condition
ArgumentOutOfRangeException The resulting DateTime is less than MinValue or greater than MaxValue.


months is less than -120,000 or greater than 120,000.


This method does not change the value of this DateTime. Instead, a new DateTime is returned whose value is the result of this operation.


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

DateTime Structure | DateTime Members | System Namespace | Double