Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

UmAlQuraCalendar.AddMonths (Método)

Calcula una fecha que está a un número determinado 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
Tipo: System.DateTime
Fecha a la que se van a agregar los meses. La clase UmAlQuraCalendar admite solo fechas comprendidas entre el 30/04/1900 a las 00.00.00 (calendario gregoriano) y el 16/11/2077 a las 23:59:59 (calendario gregoriano).
months
Tipo: System.Int32
Número positivo o negativo de meses que se van a agregar.

Valor devuelto

Tipo: System.DateTime
Fecha que es el resultado de sumar el número de meses especificado por el parámetro months a la fecha especificada por el parámetro time.
ExcepciónCondición
ArgumentException

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

ArgumentOutOfRangeException

months es menor que -120.000 o mayor que 120.000.

O bien

time está fuera del intervalo admitido por este calendario.

La parte del día de la estructura DateTime resultante 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 DateTime resultante se ve afectada si el mes resultante está fuera del año del DateTime especificado. Esta implementación sólo admite la era actual. Por consiguiente, se produce una excepción DateTime si el año resultante está fuera de la era de la estructura especificada. La parte correspondiente a la hora del día del objeto DateTime resultante se mantiene igual que la del objeto DateTime especificado.

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 del parámetro months es 3, entonces 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 del parámetro months es negativo, el DateTime resultante es anterior al DateTime especificado.

La propiedad Kind del valor devuelto DateTime siempre es igual que DateTimeKind.Unspecified. Puede conservar la propiedad Kind del parámetro time llamando al método DateTime.SpecifyKind, como se muestra en los siguientes ejemplos.


returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind);


El siguiente ejemplo crea instancias de un valor DateTime y muestra los valores de algunos de sus componentes en el calendario de Um Al Qura. Después, llama a los métodos AddMonths y AddYears para agregar 2 años y 10 meses en el calendario Um Al Qura para el valor de fecha. Finalmente, muestra de nuevo 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


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.