DateTime.AddMonths(Int32) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

DateTime.cs

Retourne un nouveau DateTime qui ajoute le nombre de mois spécifié à la valeur de cette instance.

public:
 DateTime AddMonths(int months);

public DateTime AddMonths (int months);

member this.AddMonths : int -> DateTime

Public Function AddMonths (months As Integer) As DateTime

Paramètres

months

Int32

Nombre de mois. Le paramètre months peut être négatif ou positif.

Retours

DateTime

Objet dont la valeur est égale à la somme de la date et de l'heure représentées par cette instance et de months.

Exceptions

ArgumentOutOfRangeException

Le résultat DateTime est inférieur à DateTime.MinValue ou supérieur à DateTime.MaxValue.

- ou -

months est inférieur à -120 000 ou supérieur à 120 000.

Exemples

L’exemple suivant ajoute entre zéro et quinze mois au dernier jour de décembre 2015. Dans ce cas, la méthode AddMonths retourne la date du dernier jour de chaque mois et gère correctement les années bissextiles.

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

Remarques

Cette méthode ne modifie pas la valeur de cet DateTime objet. Au lieu de cela, elle retourne un nouvel DateTime objet dont la valeur est le résultat de cette opération.

La AddMonths méthode calcule le mois et l’année résultants, en tenant compte des années bissextiles et du nombre de jours dans un mois, puis ajuste la partie jour de l’objet résultant DateTime . Si le jour résultant n’est pas un jour valide dans le mois résultant, le dernier jour valide du mois résultant est utilisé. Par exemple, 31 mars + 1 mois = 30 avril et 31 mars - 1 mois = 28 février pour une année non bissextile et 29 février pour une année bissextile.

La partie heure de la journée de l’objet résultant DateTime reste la même que cette instance.