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

Clase GregorianCalendar

 

Publicado: noviembre de 2016

Representa el calendario gregoriano.

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

System.Object
  System.Globalization.Calendar
    System.Globalization.GregorianCalendar

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class GregorianCalendar : Calendar

NombreDescripción
System_CAPS_pubmethodGregorianCalendar()

Inicializa una nueva instancia de la GregorianCalendar con el valor predeterminado de la clase GregorianCalendarTypes valor.

System_CAPS_pubmethodGregorianCalendar(GregorianCalendarTypes)

Inicializa una nueva instancia de la GregorianCalendar clase utilizando especificado GregorianCalendarTypes valor.

NombreDescripción
System_CAPS_pubpropertyAlgorithmType

Obtiene un valor que indica si el calendario actual está basado en solar, basado en el lunar o una combinación de ambos.(Invalida Calendar.AlgorithmType).

System_CAPS_pubpropertyCalendarType

Obtiene o establece la GregorianCalendarTypes valor que denota la versión de idioma de la actual GregorianCalendar.

System_CAPS_protpropertyDaysInYearBeforeMinSupportedYear

Obtiene el número de días del año anterior al año que se especifica mediante el MinSupportedDateTime propiedad.(Heredado de Calendar).

System_CAPS_pubpropertyEras

Obtiene la lista de eras de la GregorianCalendar.(Invalida Calendar.Eras).

System_CAPS_pubpropertyIsReadOnly

Obtiene un valor que indica si este Calendar objeto es de solo lectura.(Heredado de Calendar).

System_CAPS_pubpropertyMaxSupportedDateTime

Obtiene la última fecha y hora admitidas por la GregorianCalendar tipo.(Invalida Calendar.MaxSupportedDateTime).

System_CAPS_pubpropertyMinSupportedDateTime

Obtiene la primera fecha y hora admitidas por la GregorianCalendar tipo.(Invalida Calendar.MinSupportedDateTime).

System_CAPS_pubpropertyTwoDigitYearMax

Obtiene o establece el último año de un intervalo de 100 años que puede representarse mediante un año de dos dígitos.(Invalida Calendar.TwoDigitYearMax).

NombreDescripción
System_CAPS_pubmethodAddDays(DateTime, Int32)

Devuelve un DateTime que es el número especificado de días transcurridos desde especificado DateTime.(Heredado de Calendar).

System_CAPS_pubmethodAddHours(DateTime, Int32)

Devuelve un DateTime que es el número especificado de horas transcurridas desde especificado DateTime.(Heredado de Calendar).

System_CAPS_pubmethodAddMilliseconds(DateTime, Double)

Devuelve un DateTime que es el número especificado de milisegundos transcurridos desde especificado DateTime.(Heredado de Calendar).

System_CAPS_pubmethodAddMinutes(DateTime, Int32)

Devuelve un DateTime que es el número especificado de minutos transcurridos desde especificado DateTime.(Heredado de Calendar).

System_CAPS_pubmethodAddMonths(DateTime, Int32)

Devuelve un DateTime que es el número especificado de meses transcurridos desde especificado DateTime.(Invalida Calendar.AddMonths(DateTime, Int32)).

System_CAPS_pubmethodAddSeconds(DateTime, Int32)

Devuelve un DateTime que es el número especificado de segundos transcurridos desde especificado DateTime.(Heredado de Calendar).

System_CAPS_pubmethodAddWeeks(DateTime, Int32)

Devuelve un DateTime que es el número especificado de semanas aparte especificado DateTime.(Heredado de Calendar).

System_CAPS_pubmethodAddYears(DateTime, Int32)

Devuelve un DateTime que es el número especificado de años transcurridos desde especificado DateTime.(Invalida Calendar.AddYears(DateTime, Int32)).

System_CAPS_pubmethodClone()

Crea un objeto nuevo copiado del objeto Calendar actual.(Heredado de Calendar).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetDayOfMonth(DateTime)

Devuelve el día del mes especificado DateTime.(Invalida Calendar.GetDayOfMonth(DateTime)).

System_CAPS_pubmethodGetDayOfWeek(DateTime)

Devuelve el día de la semana especificado DateTime.(Invalida Calendar.GetDayOfWeek(DateTime)).

System_CAPS_pubmethodGetDayOfYear(DateTime)

Devuelve el día del año especificado DateTime.(Invalida Calendar.GetDayOfYear(DateTime)).

System_CAPS_pubmethodGetDaysInMonth(Int32, Int32)

Devuelve el número de días en el mes y año especificados de la era actual.(Heredado de Calendar).

System_CAPS_pubmethodGetDaysInMonth(Int32, Int32, Int32)

Devuelve el número de días del mes especificado del año especificado de la era especificada.(Invalida Calendar.GetDaysInMonth(Int32, Int32, Int32)).

System_CAPS_pubmethodGetDaysInYear(Int32)

Devuelve el número de días del año especificado de la era actual.(Heredado de Calendar).

System_CAPS_pubmethodGetDaysInYear(Int32, Int32)

Devuelve el número de días del año especificado de la era especificada.(Invalida Calendar.GetDaysInYear(Int32, Int32)).

System_CAPS_pubmethodGetEra(DateTime)

Devuelve la era de la manera especificada DateTime.(Invalida Calendar.GetEra(DateTime)).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetHour(DateTime)

Devuelve el valor de horas especificado DateTime.(Heredado de Calendar).

System_CAPS_pubmethodGetLeapMonth(Int32)

Calcula el mes bisiesto de un año especificado.(Heredado de Calendar).

System_CAPS_pubmethodGetLeapMonth(Int32, Int32)

Calcula el mes bisiesto de un año y era especificados.(Invalida Calendar.GetLeapMonth(Int32, Int32)).

System_CAPS_pubmethodGetMilliseconds(DateTime)

Devuelve el valor de milisegundos especificado DateTime.(Heredado de Calendar).

System_CAPS_pubmethodGetMinute(DateTime)

Devuelve el valor de minutos especificado DateTime.(Heredado de Calendar).

System_CAPS_pubmethodGetMonth(DateTime)

Devuelve el mes especificado DateTime.(Invalida Calendar.GetMonth(DateTime)).

System_CAPS_pubmethodGetMonthsInYear(Int32)

Devuelve el número de meses del año especificado de la era actual.(Heredado de Calendar).

System_CAPS_pubmethodGetMonthsInYear(Int32, Int32)

Devuelve el número de meses del año especificado de la era especificada.(Invalida Calendar.GetMonthsInYear(Int32, Int32)).

System_CAPS_pubmethodGetSecond(DateTime)

Devuelve los segundos de valor de la manera especificada DateTime.(Heredado de Calendar).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Devuelve la semana del año que incluye la fecha de la manera especificada DateTime valor.(Heredado de Calendar).

System_CAPS_pubmethodGetYear(DateTime)

Devuelve el año de la manera especificada DateTime.(Invalida Calendar.GetYear(DateTime)).

System_CAPS_pubmethodIsLeapDay(Int32, Int32, Int32)

Determina si la fecha especificada de la era actual es un día bisiesto.(Heredado de Calendar).

System_CAPS_pubmethodIsLeapDay(Int32, Int32, Int32, Int32)

Determina si la fecha especificada de la era especificada es un día bisiesto.(Invalida Calendar.IsLeapDay(Int32, Int32, Int32, Int32)).

System_CAPS_pubmethodIsLeapMonth(Int32, Int32)

Determina si el mes especificado del año especificado de la era actual es un mes bisiesto.(Heredado de Calendar).

System_CAPS_pubmethodIsLeapMonth(Int32, Int32, Int32)

Determina si el mes especificado del año especificado de la era especificada es un mes bisiesto.(Invalida Calendar.IsLeapMonth(Int32, Int32, Int32)).

System_CAPS_pubmethodIsLeapYear(Int32)

Determina si el año especificado de la era actual es un año bisiesto.(Heredado de Calendar).

System_CAPS_pubmethodIsLeapYear(Int32, Int32)

Determina si el año especificado de la era especificada es un año bisiesto.(Invalida Calendar.IsLeapYear(Int32, Int32)).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Devuelve un DateTime que se establece en la fecha y hora especificadas de la era actual.(Heredado de Calendar).

System_CAPS_pubmethodToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Devuelve un DateTime que se establece en la fecha y hora especificadas de la era especificada.(Invalida Calendar.ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)).

System_CAPS_pubmethodToFourDigitYear(Int32)

Convierte el año especificado en un año de cuatro dígitos mediante el TwoDigitYearMax propiedad para determinar el siglo adecuado.(Invalida Calendar.ToFourDigitYear(Int32)).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubfieldSystem_CAPS_staticADEra

Representa la era actual. Este campo es constante.

El calendario gregoriano consta de dos eras: A.C.. de c. y D.C. o era cristiana. Esta implementación de la GregorianCalendar clase sólo reconoce la era actual (D.C. o era cristiana).

System_CAPS_noteNota

Para obtener información acerca del uso de la GregorianCalendar clase y otras clases de .NET Framework de calendario, consulte Trabajar con calendarios.

En el calendario gregoriano un año bisiesto se define como un año divisible por 4, a menos que sea divisible por 100. Sin embargo, los años que son divisibles por 400 son años bisiestos. Por ejemplo, el año 1900 no fue un año bisiesto, pero el año 2000 sí. Un año normal tiene 365 días y un año bisiesto tiene 366 días.

El calendario gregoriano tiene 12 meses de entre 28 y 31 días cada uno: enero (31 días), febrero (28 o 29 días), marzo (31 días), abril (30 días), mayo (31 días), junio (30 días), julio (31 días), agosto (31 días), septiembre (30 días), octubre (31 días), noviembre (30 días) y diciembre (31 días). Febrero tiene 29 días los años bisiestos y 28 durante años.

System_CAPS_importantImportante

De forma predeterminada, todos los DateTime y DateTimeOffset valores expresan fechas y horas en el calendario gregoriano.

El calendario gregoriano se desarrolló como un reemplazo para el calendario juliano (que está representado por la JulianCalendar clase) y se presentó en un pequeño número de referencias culturales en el 15 de octubre de 1582. Cuando se trabaja con fechas históricas que preceden a la adopción de la referencia cultural del calendario gregoriano, debe usar el calendario original si está disponible en .NET Framework. Por ejemplo, Dinamarca cambia desde el calendario juliano para el calendario gregoriano en 19 de febrero (en el calendario juliano) o 1 de marzo (en el calendario gregoriano) de 1700. En este caso, las fechas antes de la adopción del calendario gregoriano, debe usar el calendario juliano. Sin embargo, tenga en cuenta que ninguna referencia cultural ofrece compatibilidad intrínseca para la JulianCalendar clase. Debe utilizar el JulianCalendar clase como calendario independiente. Para más información, consulte .

En el ejemplo siguiente se muestra que el 18 de febrero de 1700 en el calendario juliano, que es el último día del calendario juliano oficialmente se utilizó en Dinamarca, es un día anterior a 1 de marzo de 1700 en el calendario gregoriano.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      Thread.CurrentThread.CurrentCulture = new CultureInfo("da-DK");

      JulianCalendar jc = new JulianCalendar();
      DateTime lastDate = new DateTime(1700, 2, 18, jc);
      Console.WriteLine("Last date (Gregorian): {0:d}", lastDate);
      Console.WriteLine("Last date (Julian): {0}-{1}-{2}\n", jc.GetDayOfMonth(lastDate),
                        jc.GetMonth(lastDate), jc.GetYear(lastDate));

      DateTime firstDate = lastDate.AddDays(1);
      Console.WriteLine("First date (Gregorian): {0:d}", firstDate);
      Console.WriteLine("First date (Julian): {0}-{1}-{2}",  jc.GetDayOfMonth(firstDate),
                        jc.GetMonth(firstDate), jc.GetYear(firstDate));
   }
}
// The example displays the following output:
//       Last date (Gregorian): 28-02-1700
//       Last date (Julian): 18-2-1700
//       
//       First date (Gregorian): 01-03-1700
//       First date (Julian): 19-2-1700

Cada CultureInfo admite un conjunto de calendarios. El Calendar propiedad devuelve el calendario predeterminado para la referencia cultural y el OptionalCalendars propiedad devuelve una matriz que contiene todos los calendarios admitidos por la referencia cultural. Para cambiar el calendario utilizado por un CultureInfo, la aplicación puede establecer la Calendar propiedad a una nueva Calendar.

GetEra omite los signos de puntuación en nombres de era abreviados únicamente si el GregorianCalendar se selecciona en DateTimeFormatInfo.Calendar y la referencia cultural utiliza "A.D." como nombre de la era, es decir, "D.C." es equivalente a "AD".

En el ejemplo de código siguiente se muestra que DateTimeFormatInfo omite los signos de puntuación en el nombre de la era, si el calendario es gregoriano y la referencia cultural utiliza el nombre de era "D.C.".

using System;
using System.Globalization;


public class SamplesGregorianCalendar  {

   public static void Main()  {

      // Creates strings with punctuation and without.
      String strADPunc = "A.D.";
      String strADNoPunc = "AD";
      String strCEPunc = "C.E.";
      String strCENoPunc = "CE";

      // Calls DTFI.GetEra for each culture that uses GregorianCalendar as the default calendar.
      Console.WriteLine( "            ----- AD -----  ----- CE -----" );
      Console.WriteLine( "CULTURE     PUNC   NO PUNC  PUNC   NO PUNC  CALENDAR" );
      foreach ( CultureInfo myCI in CultureInfo.GetCultures( CultureTypes.SpecificCultures ) )  {
         Console.Write( "{0,-12}", myCI );
         Console.Write( "{0,-7}{1,-9}", myCI.DateTimeFormat.GetEra( strADPunc ), myCI.DateTimeFormat.GetEra( strADNoPunc ) );
         Console.Write( "{0,-7}{1,-9}", myCI.DateTimeFormat.GetEra( strCEPunc ), myCI.DateTimeFormat.GetEra( strCENoPunc ) );
         Console.Write( "{0}", myCI.Calendar );
         Console.WriteLine();
      }

   }

}

/*
This code produces the following output.  This output has been cropped for brevity.

            ----- AD -----  ----- CE -----
CULTURE     PUNC   NO PUNC  PUNC   NO PUNC  CALENDAR
ar-SA       -1     -1       -1     -1       System.Globalization.HijriCalendar
ar-IQ       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-EG       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-LY       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-DZ       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-MA       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-TN       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-OM       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-YE       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-SY       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-JO       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-LB       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-KW       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-AE       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-BH       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-QA       1      1        -1     -1       System.Globalization.GregorianCalendar
bg-BG       1      1        -1     -1       System.Globalization.GregorianCalendar
ca-ES       -1     -1       -1     -1       System.Globalization.GregorianCalendar
zh-TW       -1     -1       -1     -1       System.Globalization.GregorianCalendar
zh-CN       -1     -1       -1     -1       System.Globalization.GregorianCalendar
zh-HK       -1     -1       -1     -1       System.Globalization.GregorianCalendar
zh-SG       1      1        -1     -1       System.Globalization.GregorianCalendar
zh-MO       1      1        -1     -1       System.Globalization.GregorianCalendar
cs-CZ       -1     -1       -1     -1       System.Globalization.GregorianCalendar
da-DK       1      1        -1     -1       System.Globalization.GregorianCalendar

*/

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

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: