Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

© 2018 Microsoft