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 UmAlQuraCalendar.AddMonths (DateTime, Int32)

 

Publicado: octubre de 2016

Calcula una fecha que es un número especificado de meses de una fecha inicial especificada.

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

public override DateTime AddMonths(
	DateTime time,
	int months
)

Parámetros

time
Type: System.DateTime

La fecha que se va a agregar los meses. La clase UmAlQuraCalendar solo admite las fechas del 30/04/1900 00.00.00 (calendario gregoriano) al 16/11/2077 23:59:59 (calendario gregoriano).

months
Type: System.Int32

Número positivo o negativo de meses que se van a agregar.

Valor devuelto

Type: System.DateTime

La fecha de resultado de sumar el número de meses especificado por el months parámetro a la fecha especificada por el time parámetro.

Exception Condition
ArgumentException

La fecha resultante está fuera del intervalo admitido por la UmAlQuraCalendar clase.

ArgumentOutOfRangeException

months es menor que -120.000 o mayor que 120.000.

-o-

time está fuera del intervalo admitido por este calendario.

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 año del resultante DateTime se ve afectada si el mes resultante está fuera del año del objeto DateTime. Esta implementación admite sólo la era actual. Por lo tanto, se produce una excepción 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, si el mes especificado es Dulkada, que tiene 30 días, el día especificado es el 30 de dicho mes y el valor de la months del parámetro es 3, el año resultante será uno más que el año especificado, el mes resultante será Záfar y el día resultante el 29, que es el último día de Záfar.

Si el valor de la months parámetro 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.AddMonths(time, months), time.Kind);

En el ejemplo siguiente se crea un DateTime valor y muestra los valores de varias de sus componentes en el calendario Um Al-Qura. A continuación, llama a la AddYears y AddMonths métodos para agregar 2 años, 10 meses en el calendario Um-Al Qura al valor de fecha. Por último, vuelve a mostrar los valores de estos componentes de fecha en el calendario Um-Al Qura.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(2011, 4, 3, new GregorianCalendar());
      Calendar cal = new UmAlQuraCalendar();

      Console.WriteLine("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:", date1);
      DisplayCalendarInfo(cal, date1);

      // Add 2 years and 10 months by calling UmAlQuraCalendar methods.
      date1 = cal.AddYears(date1, 2);
      date1 = cal.AddMonths(date1, 10);       

      Console.WriteLine("After adding 2 years and 10 months in the {0} calendar,", 
                        GetCalendarName(cal));
      Console.WriteLine("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:", date1);
      DisplayCalendarInfo(cal, date1);
   }

   private static void DisplayCalendarInfo(Calendar cal, DateTime date1)
   {
      Console.WriteLine("   Calendar:   {0}", GetCalendarName(cal));    
      Console.WriteLine("   Era:        {0}", cal.GetEra(date1));
      Console.WriteLine("   Year:       {0}", cal.GetYear(date1));
      Console.WriteLine("   Month:      {0}", cal.GetMonth(date1));
      Console.WriteLine("   DayOfYear:  {0}", cal.GetDayOfYear(date1));
      Console.WriteLine("   DayOfMonth: {0}", cal.GetDayOfMonth(date1));
      Console.WriteLine("   DayOfWeek:  {0}\n", cal.GetDayOfWeek(date1));
   }

   private static string GetCalendarName(Calendar cal)
   {
      return cal.ToString().Replace("System.Globalization.", "").
             Replace("Calendar", "");   
   }
}
// The example displays the following output:
//    April 3, 2011 in the Gregorian calendar is equivalent to:
//       Calendar:   UmAlQura
//       Era:        1
//       Year:       1432
//       Month:      4
//       DayOfYear:  118
//       DayOfMonth: 29
//       DayOfWeek:  Sunday
//    
//    After adding 2 years and 10 months in the UmAlQura calendar,
//    January 1, 2014 in the Gregorian calendar is equivalent to:
//       Calendar:   UmAlQura
//       Era:        1
//       Year:       1435
//       Month:      2
//       DayOfYear:  59
//       DayOfMonth: 29
//       DayOfWeek:  Wednesday

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