Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método GregorianCalendar.AddYears (DateTime, Int32)

 

Publicado: octubre de 2016

Devuelve un DateTime que es el número especificado de años transcurridos desde especificado DateTime.

Espacio de nombres:   System.Globalization
Ensamblado:  mscorlib (en mscorlib.dll)

public override DateTime AddYears(
	DateTime time,
	int years
)

Parámetros

time
Type: System.DateTime

DateTime al que se van a sumar los años.

years
Type: System.Int32

El número de años a agregar.

Valor devuelto

Type: System.DateTime

El DateTime resultante de agregar el número especificado de años especificado DateTime.

Exception Condition
ArgumentException

Resultante DateTime está fuera del intervalo admitido.

La parte del día del resultante DateTime se ve afectada si el día resultante no es un día válido del mes resultante del año resultante. Se cambia al último día válido del mes resultante del año resultante. La parte del mes del resultante DateTime es el mismo que el especificado DateTime. Esta implementación admite sólo la era actual. Por lo tanto, ArgumentException se produce si el año resultante está fuera de la era de especificado DateTime. La parte de hora del día del resultante DateTime es el mismo que el especificado DateTime.

Por ejemplo, febrero tiene 28 días, excepto en años bisiestos que tiene 29 días. Si la fecha especificada es el 29 de febrero en un año bisiesto y el valor de years es 1, la fecha resultante será el día 28 de febrero del año siguiente.

Si years es negativo, resultante DateTime es anterior a la especificada DateTime.

ElKind propiedad de devuelto DateTime valor siempre es igual a DateTimeKind.Unspecified. Puede conservar la Kind propiedad de la time parámetro llamando el DateTime.SpecifyKind método, como se muestra en el ejemplo siguiente.

returnTime = DateTime.SpecifyKind(cal.AddYears(time, years), time.Kind);

El ejemplo de código siguiente muestra los valores de varios componentes de un DateTime en términos del calendario gregoriano.

using System;
using System.Globalization;


public class SamplesGregorianCalendar  {

   public static void Main()  {

      // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      DateTime myDT = new DateTime( 2002, 4, 3, new GregorianCalendar() );

      // Creates an instance of the GregorianCalendar.
      GregorianCalendar myCal = new GregorianCalendar();

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar:" );
      DisplayValues( myCal, myDT );

      // Adds two years and ten months.
      myDT = myCal.AddYears( myDT, 2 );
      myDT = myCal.AddMonths( myDT, 10 );

      // Displays the values of the DateTime.
      Console.WriteLine( "After adding two years and ten months:" );
      DisplayValues( myCal, myDT );

   }

   public static void DisplayValues( Calendar myCal, DateTime myDT )  {
      Console.WriteLine( "   Era:        {0}", myCal.GetEra( myDT ) );
      Console.WriteLine( "   Year:       {0}", myCal.GetYear( myDT ) );
      Console.WriteLine( "   Month:      {0}", myCal.GetMonth( myDT ) );
      Console.WriteLine( "   DayOfYear:  {0}", myCal.GetDayOfYear( myDT ) );
      Console.WriteLine( "   DayOfMonth: {0}", myCal.GetDayOfMonth( myDT ) );
      Console.WriteLine( "   DayOfWeek:  {0}", myCal.GetDayOfWeek( myDT ) );
      Console.WriteLine();
   }

}

/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar:
   Era:        1
   Year:       2002
   Month:      4
   DayOfYear:  93
   DayOfMonth: 3
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        1
   Year:       2005
   Month:      2
   DayOfYear:  34
   DayOfMonth: 3
   DayOfWeek:  Thursday

*/

Plataforma universal de Windows
Disponible desde 10
.NET Framework
Disponible desde 1.1
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Volver al principio
Mostrar: