DateTime.AddMonths(Int32) Metoda

Definicja

Przestrzeń nazw:

System

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

DateTime.cs

Zwraca nowy DateTime element, który dodaje określoną liczbę miesięcy do wartości tego wystąpienia.

C#

public DateTime AddMonths(int months);

Parametry

months

Int32

Liczba miesięcy. Parametr months może być ujemny lub dodatni.

Zwraca

DateTime

Obiekt, którego wartość jest sumą daty i godziny reprezentowanej przez to wystąpienie i months.

Wyjątki

ArgumentOutOfRangeException

DateTime Wynik jest mniejszy niż DateTime.MinValue lub większy niż DateTime.MaxValue.

-lub-

months wartość jest mniejsza niż -120 000 lub większa niż 120 000.

Przykłady

Poniższy przykład dodaje od zera do piętnastu miesięcy do ostatniego dnia grudnia 2015 r. W tym przypadku metoda AddMonths zwraca datę ostatniego dnia każdego miesiąca i pomyślnie obsługuje lata przestępne.

C#

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

Uwagi

Ta metoda nie zmienia wartości tego DateTime obiektu. Zamiast tego zwraca nowy DateTime obiekt, którego wartość jest wynikiem tej operacji.

Metoda AddMonths oblicza wynikowy miesiąc i rok, uwzględniając lata przestępne i liczbę dni w miesiącu, a następnie dostosowuje część dnia wynikowego DateTime obiektu. Jeśli wynikowy dzień nie jest prawidłowym dniem w wynikowym miesiącu, jest używany ostatni prawidłowy dzień wynikowego miesiąca. Na przykład 31 marca + 1 miesiąc = 30 kwietnia i 31 marca - 1 miesiąc = 28 lutego dla roku nieprzestąpnego i 29 lutego dla roku przestępnego.

Część czasowa wynikowego DateTime obiektu pozostaje taka sama jak w przypadku tego wystąpienia.

Dotyczy