DateTime.AddMonths(Int32) Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Zdroj:: DateTime.cs

Zdroj:: DateTime.cs

Zdroj:: DateTime.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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.

Platí pro

Sdílet prostřednictvím