DateTime.AddMonths(Int32) Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Zdroj:

DateTime.cs

Vrátí nový DateTime , který přidá zadaný počet měsíců k hodnotě této instance.

public:
 DateTime AddMonths(int months);

public DateTime AddMonths (int months);

member this.AddMonths : int -> DateTime

Public Function AddMonths (months As Integer) As DateTime

Parametry

months

Int32

Počet měsíců. Parametr months může být záporný nebo kladný.

Návraty

DateTime

Objekt, jehož hodnota je součtem data a času reprezentovaných touto instancí a months.

Výjimky

ArgumentOutOfRangeException

Výsledná hodnota DateTime je menší než DateTime.MinValue nebo větší než DateTime.MaxValue.

-nebo-

months je menší než -120 000 nebo větší než 120 000.

Příklady

Následující příklad přidá nula až patnáct měsíců k poslednímu prosinci 2015. V tomto případě Metoda AddMonths vrátí datum posledního dne každého měsíce a úspěšně zpracovává přestupné roky.

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

Poznámky

Tato metoda nezmění hodnotu tohoto DateTime objektu. Místo toho vrátí nový DateTime objekt, jehož hodnota je výsledkem této operace.

Metoda AddMonths vypočítá výsledný měsíc a rok s ohledem na přestupné roky a počet dnů v měsíci a pak upraví denní část výsledného DateTime objektu. Pokud výsledný den není platným dnem ve výsledném měsíci, použije se poslední platný den výsledného měsíce. Například 31. března + 1 měsíc = 30. dubna a 31. března – 1 měsíc = 28. února pro přestupný rok a 29. února pro přestupný rok.

Časová část výsledného DateTime objektu zůstává stejná jako tato instance.