DateTime.AddMonths(Int32) DateTime.AddMonths(Int32) DateTime.AddMonths(Int32) DateTime.AddMonths(Int32) Method

Définition

Retourne un nouveau DateTime qui ajoute le nombre de mois spécifié à la valeur de cette instance.Returns a new DateTime that adds the specified number of months to the value of this 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 Int32 Int32 Int32

Nombre de mois.A number of months. Le paramètre months peut être négatif ou positif.The months parameter can be negative or positive.

Retours

Objet dont la valeur est égale à la somme de la date et de l'heure représentées par cette instance et de months.An object whose value is the sum of the date and time represented by this instance and months.

Exceptions

L’objet DateTime obtenu est inférieur à MinValue ou supérieur à MaxValue.The resulting DateTime is less than MinValue or greater than MaxValue.

- ou --or- months est inférieur à -120 000 ou supérieur à 120 000.months is less than -120,000 or greater than 120,000.

Exemples

L’exemple suivant ajoute entre zéro et quinze mois au dernier jour du mois de décembre 2015.The following example adds between zero and fifteen months to the last day of December, 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.In this case, the AddMonths method returns the date of the last day of each month, and successfully handles leap years.

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
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 objet DateTime.This method does not change the value of this DateTime object. Au lieu de cela, elle retourne un nouvel objet DateTime dont la valeur est le résultat de cette opération.Instead, it returns a new DateTime object whose value is the result of this operation.

La méthode AddMonths 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 DateTime résultant.The AddMonths method calculates the resulting month and year, taking into account leap years and the number of days in a month, then adjusts the day part of the resulting DateTime object. 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é.If the resulting day is not a valid day in the resulting month, the last valid day of the resulting month is used. Par exemple, le 31 mars + 1 mois = avril 30 et 31 mars-1 mois = 28 février pour une année non bissextile et 29 février pour une année bissextile.For example, March 31st + 1 month = April 30th, and March 31st - 1 month = February 28 for a non-leap year and February 29 for a leap year.

La partie heure du jour de l’objet DateTime résultant reste identique à celle de cette instance.The time-of-day part of the resulting DateTime object remains the same as this instance.

S’applique à