DateTime.AddMonths(Int32) Méthode

Définition

Espace de noms:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Retourne un nouveau DateTime qui ajoute le nombre spécifié de mois à 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

Un certain nombre de mois. Le months paramètre peut être négatif ou positif.

Retours

DateTime

Objet dont la valeur est la somme de la date et de l’heure représentées par cette instance et 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, il 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 d’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, le 31 mars + 1 mois = le 30 avril et le 31 mars - 1 mois = 28 février pour une année non bissextile et le 29 février pour une année bissextile.

La partie du jour de l’objet résultant DateTime reste la même que cette instance.

S’applique à