Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DateTime.AddYears, méthode (Int32)

 

Retourne un nouveau DateTime qui ajoute le nombre d'années spécifié à la valeur de cette instance.

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

public DateTime AddYears(
	int value
)

Paramètres

value

Nombre d'années.Le paramètre value peut être négatif ou positif.

Valeur de retour

Type: System.DateTime

Objet dont la valeur est égale à la somme de la date et de l'heure représentées par cette instance et du nombre d'années représenté par value.

Exception Condition
ArgumentOutOfRangeException

value ou résultant DateTime est inférieure à MinValue ou supérieure à MaxValue.

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

Le AddYears méthode calcule l'année résultante en tenant compte des années bissextiles.La partie mois et l'heure du jour de résultant DateTime objet reste identique à cette instance.

Si l'instance actuelle représente l'année bissextile d'une année bissextile, la valeur de retour dépend de la date :

  • Si value + DateTime.Year est également une année bissextile, la valeur renvoyée représente le jour de cette année bissextile.Par exemple, si quatre ans est ajouté au 29 février 2012, la date renvoyée est le 29 février 2016.

  • Si value + DateTime.Year n'est pas une année bissextile, la valeur renvoyée représente le jour précédant le jour de cette année bissextile.Par exemple, si une année est ajoutée au 29 février 2012, la date renvoyée est le 28 février 2013.

L'exemple suivant illustre l'utilisation de la AddYears méthode avec un DateTime valeur qui représente un jour de l'année bissextile.Afficher la date pour les années antérieures à quinze et quinze années qui suivent le 29 février 2000.

using System;

public class Example
{
   public static void Main()
   {
      DateTime baseDate = new DateTime(2000, 2, 29);
      Console.WriteLine("    Base Date:        {0:d}\n", baseDate);

      // Show dates of previous fifteen years.
      for (int ctr = -1; ctr >= -15; ctr--)
         Console.WriteLine("{0,2} year(s) ago:        {1:d}", 
                           Math.Abs(ctr), baseDate.AddYears(ctr));
      Console.WriteLine();

      // Show dates of next fifteen years.
      for (int ctr = 1; ctr <= 15; ctr++)
         Console.WriteLine("{0,2} year(s) from now:   {1:d}", 
                           ctr, baseDate.AddYears(ctr));
   }
}
// The example displays the following output:
//           Base Date:        2/29/2000
//       
//        1 year(s) ago:        2/28/1999
//        2 year(s) ago:        2/28/1998
//        3 year(s) ago:        2/28/1997
//        4 year(s) ago:        2/29/1996
//        5 year(s) ago:        2/28/1995
//        6 year(s) ago:        2/28/1994
//        7 year(s) ago:        2/28/1993
//        8 year(s) ago:        2/29/1992
//        9 year(s) ago:        2/28/1991
//       10 year(s) ago:        2/28/1990
//       11 year(s) ago:        2/28/1989
//       12 year(s) ago:        2/29/1988
//       13 year(s) ago:        2/28/1987
//       14 year(s) ago:        2/28/1986
//       15 year(s) ago:        2/28/1985
//       
//        1 year(s) from now:   2/28/2001
//        2 year(s) from now:   2/28/2002
//        3 year(s) from now:   2/28/2003
//        4 year(s) from now:   2/29/2004
//        5 year(s) from now:   2/28/2005
//        6 year(s) from now:   2/28/2006
//        7 year(s) from now:   2/28/2007
//        8 year(s) from now:   2/29/2008
//        9 year(s) from now:   2/28/2009
//       10 year(s) from now:   2/28/2010
//       11 year(s) from now:   2/28/2011
//       12 year(s) from now:   2/29/2012
//       13 year(s) from now:   2/28/2013
//       14 year(s) from now:   2/28/2014
//       15 year(s) from now:   2/28/2015

Universal Windows Platform
Disponible depuis 4.5
.NET Framework
Disponible depuis 1.1
Portable Class Library
Pris en charge dans : portable .NET platforms
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: