DateTime.AddMonths(Int32) Methode

Definitie

Naamruimte:
System
Assembly's:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Retourneert een nieuw DateTime dat het opgegeven aantal maanden toevoegt aan de waarde van dit exemplaar.

public:
 DateTime AddMonths(int months);
public DateTime AddMonths(int months);
member this.AddMonths : int -> DateTime
Public Function AddMonths (months As Integer) As DateTime

Parameters

months
Int32

Een aantal maanden. De months parameter kan negatief of positief zijn.

Retouren

DateTime

Een object waarvan de waarde de som is van de datum en tijd die wordt vertegenwoordigd door dit exemplaar en months.

Uitzonderingen

ArgumentOutOfRangeException

Het resultaat DateTime is kleiner dan DateTime.MinValue of hoger dan DateTime.MaxValue.

– of –

months is kleiner dan -120.000 of groter dan 120.000.

Voorbeelden

In het volgende voorbeeld wordt tussen nul en vijftien maanden toegevoegd aan de laatste dag van december 2015. In dit geval retourneert de methode AddMonths de datum van de laatste dag van elke maand en worden schrikkeljaren verwerkt.

using System;

public class Example
{
   public static void Main()
   {
      var dat = new DateTime(2015, 12, 31);
      for (int ctr = 0; ctr <= 15; ctr++)
         Console.WriteLine(dat.AddMonths(ctr).ToString("d"));
   }
}
// The example displays the following output:
//       12/31/2015
//       1/31/2016
//       2/29/2016
//       3/31/2016
//       4/30/2016
//       5/31/2016
//       6/30/2016
//       7/31/2016
//       8/31/2016
//       9/30/2016
//       10/31/2016
//       11/30/2016
//       12/31/2016
//       1/31/2017
//       2/28/2017
//       3/31/2017

open System

let dat = DateTime(2015, 12, 31)
for i = 0 to 15 do
    printfn $"{dat.AddMonths i:d}"

// The example displays the following output:
//       12/31/2015
//       1/31/2016
//       2/29/2016
//       3/31/2016
//       4/30/2016
//       5/31/2016
//       6/30/2016
//       7/31/2016
//       8/31/2016
//       9/30/2016
//       10/31/2016
//       11/30/2016
//       12/31/2016
//       1/31/2017
//       2/28/2017
//       3/31/2017

Module Example
   Public Sub Main()
      Dim dat As Date = #12/31/2015#
      For ctr As Integer = 0 To 15
         Console.WriteLine(dat.AddMonths(ctr).ToString("d"))
      Next
   End Sub
End Module
' The example displays the following output:
'       12/31/2015
'       1/31/2016
'       2/29/2016
'       3/31/2016
'       4/30/2016
'       5/31/2016
'       6/30/2016
'       7/31/2016
'       8/31/2016
'       9/30/2016
'       10/31/2016
'       11/30/2016
'       12/31/2016
'       1/31/2017
'       2/28/2017
'       3/31/2017

Opmerkingen

Met deze methode wordt de waarde van dit DateTime object niet gewijzigd. In plaats daarvan wordt een nieuw DateTime object geretourneerd waarvan de waarde het resultaat is van deze bewerking.

De AddMonths methode berekent de resulterende maand en het resulterende jaar, rekening houdend met schrikkeljaren en het aantal dagen in een maand, en past vervolgens het daggedeelte van het resulterende DateTime object aan. Als de resulterende dag geen geldige dag is in de resulterende maand, wordt de laatste geldige dag van de resulterende maand gebruikt. Bijvoorbeeld: 31 maart + 1 maand = 30 april en 31 maart - 1 maand = 28 februari voor een niet-schrikkeljaar en 29 februari voor een schrikkeljaar.

Het tijdstip van de dag van het resulterende DateTime object blijft hetzelfde als dit exemplaar.

Van toepassing op