módulo  java.base
paquete  java.util

Class Calendar

  • Todas las interfaces implementadas
    Serializable , Cloneable , Comparable<Calendar>
    Subclases directas conocidas:
    GregorianCalendar

    public abstract class Calendar
    extends Object
    implements Serializable, Cloneable, Comparable<Calendar>
    la mencionadaCalendarclase es una clase abstracta que puede proporcionar métodos para la conversión entre un instante específico y un conjuntocalendar fieldsComoYEAR , MONTH , DAY_OF_MONTH , HOUR, etc., así como para manipular los campos del calendario, como obtener la fecha de la próxima semana. El instante se puede representar mediante un valor en milisegundos, que es el valor del 1 de enero de 1970, 00:00:00,000 (gregoriano), hora media de Greenwich.EpochEl desplazamiento.

    Esta clase también proporciona campos y métodos adicionales para implementar sistemas de calendario específicos fuera del paquete Estos campos y métodos se definen comoprotected 。

    Al igual que otras clases sensibles a la configuración regional,CalendarProporciona un método de clase.getInstance, que se utiliza para obtener un objeto genérico de este tipo. CalendardegetInstanceEl método devuelve unCalendarEl objeto, cuyos campos de calendario se han inicializado con la fecha y hora actuales:

         Calendar rightNow = Calendar.getInstance();
     

    CalendarUn objeto puede generar todos los valores de campo de calendario necesarios para implementar formatos de fecha y hora de un idioma y estilo de calendario específicos (por ejemplo, japonés - gregoriano, japonés - tradicional). CalendarDefine el rango de valores devueltos por ciertos campos de calendario y su significado. Por ejemplo, el valor del primer mes del sistema de calendario para todos los calendarios esMONTH == JANUARY 。 Otros valores los definen subclases concretas, por ejemploERA 。 Para obtener más información, consulte la documentación de cada campo y la documentación de las subclases.

    Obtener y establecer valores de campo de calendario

    Se puede mediante la llamada alsetmétodo para establecer los valores de campo de calendario. CalendarNingún valor de campo establecido se interpreta hasta que sea necesario calcular su valor de tiempo (milisegundos desde Epoch) o los valores de los campos de calendario. La llamadaget , getTimeInMillis , getTime , addyrollimplica dicho cálculo.

    Indulgencia

    Calendartiene la interpretación de los campos de calendario,indulgente , no indulgentedos modos. CuandoCalendarCuando está en modo indulgente, acepta un rango más amplio de valores de campo de calendario que los que produce. CuandoCalendarAl recalcular losCalendarvalores de campo de calendario devueltos,get()todos los campos de calendario se normalizan. Por ejemplo, en modo indulgenteGregorianCalendarinterpretaMONTH == JANUARY , DAY_OF_MONTH == 32como el 1 de febrero.

    CuandoCalendarCuando está en modo no indulgente, si hay alguna inconsistencia en sus campos de calendario, se lanza una excepción. Por ejemplo,GregorianCalendarsiempre genera valores entre 1 y la duración del mesDAY_OF_MONTHvalores. Si se ha establecido algún valor de campo fuera de rango, el modo no indulgenteGregorianCalendarlanza una excepción al calcular su valor de tiempo o los valores de campo de calendario.

    First Week

    CalendarSe define la semana laboral de siete días específica de la configuración regional mediante dos parámetros: el primer día de la semana y el número mínimo de días de la primera semana (de 1 a 7). Al construirCalendar, estos números se toman de los datos de recursos de la configuración regional o de la propia configuración regional. Si la configuración regional especificada contiene “fw” y/o “rg”Unicode extensions, entonces el primer día de la semana se obtendrá de acuerdo con estas extensiones. Si se especifican “fw” y “rg” al mismo tiempo, el valor de la extensión “fw” reemplazará el valor implícito de la extensión “rg”. También se pueden especificar explícitamente mediante métodos que establecen sus valores.

    Al establecer u obtenerWEEK_OF_MONTHoWEEK_OF_YEARel campo,Calendarla primera semana del mes o del año debe determinarse como punto de referencia. La primera semana de un mes o de un año se define como el período de siete días más temprano que comienza engetFirstDayOfWeek()y contiene al menosgetMinimalDaysInFirstWeek()días de ese mes o de ese año. Las semanas anteriores a la primera semana se numeran ..., -1, 0; las semanas que le siguen se numeran 2, 3, ... Tenga en cuenta queget()Los números normalizados devueltos pueden ser diferentes. Por ejemplo, unaCalendarsubclase puede designar la semana anterior a la semana 1 del año como la semanandel año anterior.

    Resolución de campos de calendario

    Al calcular la fecha y la hora a partir de los campos de calendario, puede que no haya suficiente información para el cálculo (por ejemplo, solo año y mes sin día), o puede haber información inconsistente (por ejemplo, martes 15 de julio de 1996 (gregoriano) - el 15 de julio de 1996 en realidad es lunes). CalendarLos valores de los campos de calendario se resolverán para determinar la fecha y la hora de la siguiente manera.

    If there is any conflict in calendar field values, Calendar gives priorities to calendar fields that have been set more recently.Las siguientes son las combinaciones predeterminadas de los campos de calendario. Se utilizará la combinación más reciente determinada por el campo individual establecido más recientemente.

    For the date fields :

     YEAR + MONTH + DAY_OF_MONTH
     YEAR + MONTH + WEEK_OF_MONTH + DAY_OF_WEEK
     YEAR + MONTH + DAY_OF_WEEK_IN_MONTH + DAY_OF_WEEK
     YEAR + DAY_OF_YEAR
     YEAR + DAY_OF_WEEK + WEEK_OF_YEAR
     
    For the time of day fields :
     HOUR_OF_DAY
     AM_PM + HOUR
     

    Si el valor de algún campo de calendario no está establecido en la combinación de campos seleccionada, entoncesCalendarse utilizará su valor predeterminado. El valor predeterminado de cada campo puede variar según el sistema de calendario específico. Por ejemplo, enGregorianCalendar, el valor predeterminado de un campo es el inicio de la misma era: es decirYEAR = 1970 , MONTH = JANUARY , DAY_OF_MONTH = 1, etc.

    Nota:Existen ciertas ambigüedades posibles en la interpretación de algunos tiempos singulares, que se pueden resolver de la siguiente manera:

    1. 23:59 es el último minuto del día, y 00:00 es el primer minuto del día siguiente. Por lo tanto, 31 de diciembre de 1999 23:59 < 1 de enero de 2000 00:00 < 00:01 del 1 de enero de 2000.
    2. Aunque históricamente inexacto, la medianoche también pertenece a "AM" y el mediodía pertenece a "PM", por lo que en el mismo día, 12:00 a.m. (medianoche) < 12:01 a.m., y 12:00 p.m. (mediodía) < 12:01 p.m.

    Las cadenas de formato de fecha u hora no forman parte de la definición del calendario, porque los usuarios deben poder modificar o sobrescribir estas cadenas en tiempo de ejecución. UsarDateFormatFormatear fechas.

    Manipulación de campos.

    : Los campos del calendario se pueden cambiar de tres maneras.set() , add()yroll() 。

    set(f, value)Cambiar los campos del calendario.fhastavalue 。 Además, establece una variable miembro interna para indicar que el campo de calendariofha cambiado. Aunque el campo de calendariofse cambia inmediatamente, el valor de tiempo del calendario en milisegundos no se vuelve a calcular hasta la siguiente llamadaget() , getTime() , getTimeInMillis() , add(), oroll()se realiza. Por lo tanto, aset()las llamadas múltiples no provocarán múltiples cálculos innecesarios. Como resultado de usarset()cambiar los campos de calendario, otros campos de calendario también pueden cambiar, según el campo de calendario, el valor del campo de calendario y el sistema de calendario. Además,get(f)no necesariamente devuelvevaluea través de una llamada asetal método después de que los campos de calendario hayan sido recalculados. La situación específica está determinada por la clase de calendario concreta.

    Por ejemplo: ConsidereGregorianCalendarinicialmente configurado para el 31 de agosto de 1999,set(Calendar.MONTH, Calendar.SEPTEMBER)establezca la fecha al 31 de septiembre de 1999. Esta es una representación interna temporal que se resuelve al 1 de octubre de 1999, sigetTime(), y luego llame. Sin embargo, al llamarset(Calendar.DAY_OF_MONTH, 30)llamar antesgetTime()establecer la fecha al 30 de septiembre de 1999, porque enset()después no se vuelve a calcular.

    add(f, delta)Agregardeltaal campof 。 esto equivale a llamar con dos ajustesset(f, get(f) + delta) :

    Add rule 1. The value of field f after the call minus the value of field f before the call is delta, modulo any overflow that has occurred in field f. Overflow occurs when a field value exceeds its range and, as a result, the next larger field is incremented or decremented and the field value is adjusted back into its range.

    Add rule 2. If a smaller field is expected to be invariant, but it is impossible for it to be equal to its prior value because of changes in its minimum or maximum after field f is changed or other constraints, such as time zone offset changes, then its value is adjusted to be as close as possible to its expected value. A smaller field represents a smaller unit of time. HOUR is a smaller field than DAY_OF_MONTH. No adjustment is made to smaller fields that are not expected to be invariant. The calendar system determines what fields are expected to be invariant.

    Además, conset()diferente,add()obliga a recalcular inmediatamente los milisegundos del calendario y todos los campos.

    Por ejemplo: ConsidereGregorianCalendarinicialmente configurado para el 31 de agosto de 1999,add(Calendar.MONTH, 13)establecer el calendario al 30 de septiembre de 2000Regla de adición 1establecerMONTHcampo a septiembre, porque agregar 13 meses da septiembre del año siguiente. Dado queDAY_OF_MONTHno puede estar en septiembre deGregorianCalendar, por lo tantoRegla de adición 2va aDAY_OF_MONTHse establece al valor más cercano posible. Aunque es un campo menor,DAY_OF_WEEKla regla 2 no ajustaDAY_OF_WEEKpara ajustarlo, porque cuando el mes enGregorianCalendarcambia, se espera que cambie.

    roll(f, delta)Agregardeltaal campofNo cambia los campos más grandes. esto equivale a llamar con los siguientes ajustesadd(f, delta) :

    Roll rule. Larger fields are unchanged after the call. A larger field represents a larger unit of time. DAY_OF_MONTH is a larger field than HOUR.

    Ejemplo: consulteGregorianCalendar.roll(int, int) 。

    patrón de uso 。 Para provocaradd()yroll()el comportamiento, considere un componente de interfaz de usuario con botones de incremento y decremento para el mes, el día y el año y el subyacenteGregorianCalendarcomponente de interfaz de usuario. Si la interfaz muestra el 31 de enero de 1999 y el usuario presiona el botón de incremento de mes, ¿qué debería mostrar? Si la implementación subyacente utilizaset(), podría mostrar el 3 de marzo de 1999. Un mejor resultado sería el 28 de febrero de 1999. Además, si el usuario vuelve a presionar el botón de incremento de mes, debería ser el 31 de marzo de 1999, en lugar del 28 de marzo de 1999. Al guardar la fecha original y usaradd()oroll(),dependiendo de si debería afectar a campos más grandes, la interfaz de usuario puede funcionar como la mayoría de los usuarios esperan intuitivamente.

    Desde la versión:
    1.1
    Véase también:
    System.currentTimeMillis() , Date , GregorianCalendar , TimeZone , DateFormat , Serialized Form
    • Resumen de clases anidadas

      Clase anidada  
      Variables y tipos Clase Descripción
      static class  Calendar.Builder
      Calendar.BuilderSe utiliza para crear a partir de varios parámetros de fecha y hora.Calendar 。
    • Resumen de campos

      Campo  
      Variables y tipos Campo Descripción
      static int ALL_STYLES
      getDisplayNamesEl especificador de estilo, que indica los nombres en todos los estilos, por ejemplo, “January” y “Jan”.
      static int AM
      AM_PMValor del campo, que representa el período del día desde la medianoche hasta antes del mediodía.
      static int AM_PM
      getysetEl número de campo indicaHOURsi es antes o después del mediodía.
      static int APRIL
      MONTHValor del campo, que representa el cuarto mes del año en los calendarios gregoriano y juliano.
      protected boolean areFieldsSet
      Sifields[]sincronizado con la hora actualmente establecida,fields[] True。
      static int AUGUST
      MONTHValor del campo, que representa el octavo mes del año en los calendarios gregoriano y juliano.
      static int DATE
      getysetEl número de campo indica el día del mes.
      static int DAY_OF_MONTH
      getysetEl número de campo indica el día del mes.
      static int DAY_OF_WEEK
      El número de campogetysetindica el día de la semana.
      static int DAY_OF_WEEK_IN_MONTH
      getysetNúmero de campo, que indica el ordinal de un día en el mes actual.
      static int DAY_OF_YEAR
      getysetEl número de campo indica el número de día del año.
      static int DECEMBER
      MONTHValor del campo, que representa el duodécimo mes del año en los calendarios gregoriano y juliano.
      static int DST_OFFSET
      getysetNúmero de campo que indica el desplazamiento del horario de verano (en milisegundos).
      static int ERA
      getysetEl número de campo indica la era, por ejemplo, AD o BC en el calendario juliano.
      static int FEBRUARY
      MONTHValor del campo, que representa el segundo mes del año en los calendarios gregoriano y juliano.
      static int FIELD_COUNT
      getysetEl número de campos distintos reconocidos.
      protected int[] campo
      Los valores de los campos de calendario para la hora actualmente establecida de este calendario.
      static int FRIDAY
      DAY_OF_WEEKEl valor del campo representa el viernes.
      static int HOUR
      getysetEl número de campo representa la hora de la mañana o de la tarde.
      static int HOUR_OF_DAY
      getysetEl número de campo representa la hora del día.
      protected boolean[] isSet
      Indicador que indica si el campo especificado del calendario se ha establecido.
      protected boolean isTimeSet
      Si entoncestimeel valor es válidotimeVerdadero.
      static int JANUARY
      MONTHEl valor del campo que representa el primer mes del año en los calendarios gregoriano y juliano.
      static int JULY
      MONTHEl valor del campo que representa el séptimo mes del año en los calendarios gregoriano y juliano.
      static int JUNE
      MONTHEl valor del campo que representa el sexto mes del año en los calendarios gregoriano y juliano.
      static int LONG
      getDisplayNameygetDisplayNamesdeDescripción del estilocarácter, equivalente aLONG_FORMAT 。
      static int LONG_FORMAT
      getDisplayNameygetDisplayNamesdeDescripción del estilocarácter, indica el nombre largo utilizado para el formato.
      static int LONG_STANDALONE
      getDisplayNameygetDisplayNamesdeDescripción del estilocarácter, que representa el nombre largo utilizado de forma independiente, por ejemplo, el nombre del mes como título del calendario.
      static int MARCH
      MONTHEl valor del campo que representa el tercer mes del año en los calendarios gregoriano y juliano.
      static int MAY
      MONTHEl valor del campo que representa el quinto mes del año en los calendarios gregoriano y juliano.
      static int MILLISECOND
      getysetEl número de campo representa los milisegundos dentro del segundo.
      static int MINUTE
      getysetEl número de campo representa los minutos dentro de la hora.
      static int MONDAY
      DAY_OF_WEEKEl valor del campo representa el lunes.
      static int MONTH
      getysetEl número de campo representa el mes.
      static int NARROW_FORMAT
      getDisplayNameygetDisplayNamesdeDescripción del estilocarácter, indica el nombre estrecho utilizado para el formato.
      static int NARROW_STANDALONE
      getDisplayNameygetDisplayNamesdeDescripción del estilocarácter , independienteIndica el nombre estrecho.
      static int NOVEMBER
      MONTHEl valor del campo que representa el undécimo mes del año en los calendarios gregoriano y juliano.
      static int OCTOBER
      MONTHEl valor del campo que representa el décimo mes del año en los calendarios gregoriano y juliano.
      static int PM
      AM_PMEl valor del campo que representa el período del día desde el mediodía hasta antes de la medianoche.
      static int SATURDAY
      Que representa el sábado.DAY_OF_WEEKEl valor del campo.
      static int SECOND
      getysetEl número de campo representa el segundo dentro del minuto.
      static int SEPTEMBER
      MONTHEl valor del campo, que representa el noveno mes del año en los calendarios gregoriano y juliano.
      static int SHORT
      getDisplayNameygetDisplayNamesdeDescripción del estilocarácter, equivalente aSHORT_FORMAT 。
      static int SHORT_FORMAT
      getDisplayNameygetDisplayNamesdeDescripción del estilocarácter, indica los nombres cortos utilizados para dar formato.
      static int SHORT_STANDALONE
      getDisplayNameygetDisplayNamesdeDescripción del estilocarácter, indica los nombres cortos de uso independiente, por ejemplo, las abreviaturas de los meses como títulos de calendario.
      static int SUNDAY
      Que representa el domingo.DAY_OF_WEEKEl valor del campo.
      static int THURSDAY
      DAY_OF_WEEKEl valor del campo representa el jueves.
      protected long time
      El tiempo establecido actualmente en este calendario, expresado en milisegundos transcurridos desde el 1 de enero de 1970, 00:00:00, hora estándar de Greenwich.
      static int TUESDAY
      Que representa el martes.DAY_OF_WEEKEl valor del campo.
      static int UNDECIMBER
      MONTHEl valor del campo, que representa el decimotercer mes del año.
      static int WEDNESDAY
      DAY_OF_WEEKEl valor del campo representa el miércoles.
      static int WEEK_OF_MONTH
      getysetEl número de campo,get setEl número de la semana.
      static int WEEK_OF_YEAR
      getysetEl número de campo representa el número de semana del año actual.
      static int YEAR
      El número de campogetysetRepresenta el año.
      static int ZONE_OFFSET
      getysetEl número de campo, que representa el desplazamiento original respecto de GMT (en milisegundos).
    • Resumen de constructores

      Método constructor  
      Variable Constructor Descripción
      protected Calendar()
      Usando la zona horaria predeterminada y laFORMATconfiguración regional predeterminada para construir un calendario.
      protected Calendar​(TimeZone zone, Locale aLocale)
      Construye un calendario con la zona horaria y la configuración regional especificadas.
    • Resumen de métodos

      Todos los métodos  Método estático  Método de instancia Método abstracto  Método específico 
      Variables y tipos Método Descripción
      abstract void add​(int field, int amount)
      Añade o resta la cantidad de tiempo especificada al campo de calendario dado, según las reglas del calendario.
      boolean after​(Object when)
      Devuelve esteCalendarSi representa lo especificadoObjectEl tiempo posterior al tiempo representado.
      boolean before​(Object when)
      Devuelve esteCalendarSi representa lo especificadoObjectEl tiempo anterior al tiempo representado.
      void clear()
      Establece esteCalendarTodos los valores de los campos del calendario y el valor de tiempo sin definir (la distancia desdede la épocael desplazamiento en milisegundos).
      void clear​(int field)
      Establece esteCalendarEl valor del campo del calendario dado y el valor de tiempo sin definir (la distancia desdede la épocael desplazamiento en milisegundos).
      Object clone()
      Crea y devuelve una copia de este objeto.
      int compareTo​(Calendar anotherCalendar)
      Compara dosCalendarEl valor de tiempo representado por el objeto (desdeel inicio de Epochdesplazamiento en milisegundos).
      protected void complete()
      Rellene cualquier campo no establecido en los campos de calendario.
      protected abstract void computeFields()
      el valor de tiempo actual en milisegundos se convierte atimelos valores de los campos de calendariofields[] 。
      protected abstract void computeTime()
      va afields[]Medioel valor actual del campo de calendarioconvertira un valor de tiempo en milisegundostime 。
      boolean equals​(Object obj)
      estoCalendarcon el especificadoObject 。
      int get​(int field)
      Devuelve el valor del campo de calendario dado.
      int getActualMaximum​(int field)
      dado esteCalendardel valor de tiempo, devuelve el valor que el campo de calendario especificado puede tenerCalendar 。
      int getActualMinimum​(int field)
      dado esteCalendardel valor de tiempo, devuelve el valor que el campo de calendario especificado puede tenerCalendar 。
      static Set<String> getAvailableCalendarTypes()
      Devuelve un objeto inmutableSetque contiene en el entorno de ejecuciónCalendartodos los tipos de calendario admitidos.
      static Locale[] getAvailableLocales()
      Devuelve una matriz de todas las configuraciones regionales,getInstanceel método puedegetInstancedevolver una instancia localizada.
      String getCalendarType()
      Devuelve esteCalendardel tipo de calendario.
      String getDisplayName​(int field, int style, Locale locale)
      Devuelve elstyleylocalecalendariocampola representación de cadena del valorlocale 。
      Map<String,​Integer> getDisplayNames​(int field, int style, Locale locale)
      DevuelveMapque contiene el especificadostyleylocalecalendariocampotodos los nombres y sus valores de campo correspondientes.
      int getFirstDayOfWeek()
      Obtener cuál es el primer día de la semana; Por ejemplo,SUNDAYEn los Estados Unidos,MONDAYen Francia.
      abstract int getGreatestMinimum​(int field)
      Devuelve esteCalendarel valor mínimo más alto del campo de calendario dado de la instancia.
      static Calendar getInstance()
      Obtener un calendario con la zona horaria y la configuración regional predeterminadas.
      static Calendar getInstance​(Locale aLocale)
      Obtener un calendario con la zona horaria predeterminada y la configuración regional especificada.
      static Calendar getInstance​(TimeZone zone)
      Obtener un calendario con la zona horaria especificada y la configuración regional predeterminada.
      static Calendar getInstance​(TimeZone zone, Locale aLocale)
      Obtener un calendario con la zona horaria y la configuración regional especificadas.
      abstract int getLeastMaximum​(int field)
      Devuelve esteCalendarel valor máximo más bajo del campo de calendario dado de la instancia.
      abstract int getMaximum​(int field)
      Devuelve esteCalendardel campo de calendario dado de la instanciaCalendar 。
      int getMinimalDaysInFirstWeek()
      Obtener el número mínimo de días necesario para la primera semana del año; Por ejemplo, si la primera semana se define como la semana que contiene el primer día del primer mes del año, entonces este método devuelve 1.
      abstract int getMinimum​(int field)
      Devuelve esteCalendardel campo de calendario dado de la instanciaCalendar 。
      Date getTime()
      Devuelve unDateobjeto que representa esteCalendarel valor de tiempo (distanciade la épocael desplazamiento en milisegundos).
      long getTimeInMillis()
      Devuelve el valor de tiempo de este Calendar en milisegundos.
      TimeZone getTimeZone()
      Obtiene la zona horaria.
      int getWeeksInWeekYear()
      Devuelve esteCalendarla semana de la semana representadaCalendar 。
      int getWeekYear()
      Devuelve esteCalendarrepresentadoCalendar 。
      int hashCode()
      Devuelve el código hash de este calendario.
      protected int internalGet​(int field)
      Devuelve el valor del campo de calendario dado.
      boolean isLenient()
      Indica si la interpretación de fecha/hora es tolerante.
      boolean isSet​(int field)
      Determina si un campo de calendario dado tiene un valor establecido, incluyendo porgetel caso de valores establecidos por cálculo de campo interno activado por llamadas a métodos.
      boolean isWeekDateSupported()
      Devuelve esteCalendarSi se admiten fechas semanales.
      abstract void roll​(int field, boolean up)
      Añade o resta (hacia arriba/abajo) una única unidad de tiempo en un campo de tiempo dado sin cambiar los campos mayores.
      void roll​(int field, int amount)
      Añade la cantidad (con signo) especificada al campo de calendario especificado, sin cambiar los campos mayores.
      void set​(int field, int value)
      Establece el campo de calendario dado al valor dado.
      void set​(int year, int month, int date)
      Establece el valor del campo de calendarioYEAR , MONTHyDAY_OF_MONTH 。
      void set​(int year, int month, int date, int hourOfDay, int minute)
      Establece el valor del campo de calendarioYEAR , MONTH , DAY_OF_MONTH , HOUR_OF_DAYyMINUTE 。
      void set​(int year, int month, int date, int hourOfDay, int minute, int second)
      Establece el valor en el campoYEAR , MONTH , DAY_OF_MONTH , HOUR_OF_DAY , MINUTEySECOND 。
      void setFirstDayOfWeek​(int value)
      Establece cuál es el primer día de la semana; Por ejemplo,SUNDAYEn los Estados Unidos,MONDAYen Francia.
      void setLenient​(boolean lenient)
      Especifica si la interpretación de fecha/hora es tolerante.
      void setMinimalDaysInFirstWeek​(int value)
      Establece el número mínimo de días requerido para la primera semana del año; Por ejemplo, si la primera semana se define como la semana que contiene el primer día del primer mes del año, llame a este método con el valor 1.
      void setTime​(Date date)
      Usando el valor dadoDateEstablece el tiempo de este Calendar.
      void setTimeInMillis​(long millis)
      Establece el tiempo actual de este Calendar a partir del valor long dado.
      void setTimeZone​(TimeZone value)
      Establece la zona horaria con el valor de zona horaria dado.
      void setWeekDate​(int weekYear, int weekOfYear, int dayOfWeek)
      Establece esto usando el especificador de fecha dadoCalendarla fecha - año de semana, día de la semana y día de la semana.
      Instant toInstant()
      Convierte este objeto aInstant 。
      String toString()
      Devuelve la representación de cadena de este calendario.
    • Detalles de campos

      • YEAR

        public static final int YEAR
        getysetEl número de campo representa el año. Este es un valor específico del calendario; Consulte la documentación de la subclase.
        Véase también:
        Valores de campo constantes
      • WEEK_OF_YEAR

        public static final int WEEK_OF_YEAR
        getysetEl número de campo representa el número de semana del año actual. RazóngetFirstDayOfWeek()ygetMinimalDaysInFirstWeek()La primera semana definida del año tiene el valor 1. Las subclases definen los días anteriores a la primera semana del añoWEEK_OF_YEARel valor de.
        Véase también:
        getFirstDayOfWeek() , getMinimalDaysInFirstWeek() , Valores de campo constantes
      • WEEK_OF_MONTH

        public static final int WEEK_OF_MONTH
        getysetEl número de campo indicagetEl número de la semana. RazóngetFirstDayOfWeek()ygetMinimalDaysInFirstWeek()La primera semana definida del mes tiene el valor 1. Las subclases definen el valor de los días anteriores a la primera semana del mes.WEEK_OF_MONTH 。
        Véase también:
        getFirstDayOfWeek() , getMinimalDaysInFirstWeek() , Valores de campo constantes
      • DATE

        public static final int DATE
        getysetEl número de campo indica el día del mes. Esto esDAY_OF_MONTHel sinónimo de. El valor del primer día del mes es 1.
        Véase también:
        DAY_OF_MONTH , Valores de campo constantes
      • DAY_OF_MONTH

        public static final int DAY_OF_MONTH
        getysetEl número de campo indica el día del mes. Esto esDATEel sinónimo de. El valor del primer día del mes es 1.
        Véase también:
        DATE , Valores de campo constantes
      • DAY_OF_YEAR

        public static final int DAY_OF_YEAR
        getysetEl número de campo indica el número de día del año. El valor del primer día del año es 1.
        Véase también:
        Valores de campo constantes
      • DAY_OF_WEEK_IN_MONTH

        public static final int DAY_OF_WEEK_IN_MONTH
        getysetNúmero de campo que representa el ordinal del día de la semana dentro del mes. yDAY_OF_WEEKJunto con el campo, esto especifica de manera única un día dentro del mes. A diferencia deWEEK_OF_MONTHyWEEK_OF_YEAR, el valor de este camponodepende degetFirstDayOfWeek()ogetMinimalDaysInFirstWeek() 。 DAY_OF_MONTH 1hasta7siempre correspondeDAY_OF_WEEK_IN_MONTH 1 ; 8llegar14corresponde aDAY_OF_WEEK_IN_MONTH 2, y así sucesivamente. DAY_OF_WEEK_IN_MONTH 0representaDAY_OF_WEEK_IN_MONTH 1la semana anterior. Los valores negativos se cuentan desde el final del mes, por lo que el último domingo del mes se designa comoDAY_OF_WEEK = SUNDAY, DAY_OF_WEEK_IN_MONTH = -1 。 Dado que los valores negativos cuentan hacia atrás, normalmente se alinean dentro del mes de manera diferente a los valores positivos. Por ejemplo, si un mes tiene 31 días, entoncesDAY_OF_WEEK_IN_MONTH -1se superpondrá conDAY_OF_WEEK_IN_MONTH 5y4el final.
        Véase también:
        DAY_OF_WEEK , WEEK_OF_MONTH , Valores de campo constantes
      • AM_PM

        public static final int AM_PM
        getysetEl número de campo indicaHOURsi es antes o después del mediodía. Por ejemplo, a las 10:04 p. m.:AM_PMSíPM 。
        Véase también:
        AM , PM , HOUR , Valores de campo constantes
      • HOUR

        public static final int HOUR
        getysetEl número de campo representa la hora de la mañana o de la tarde. HOURse utiliza para el formato de 12 horas (0 - 11). El mediodía y la medianoche se representan con 0, no con 12. Por ejemplo, a las 10:04:15.250 PM,HOURes 10.
        Véase también:
        AM_PM , HOUR_OF_DAY , Valores de campo constantes
      • HOUR_OF_DAY

        public static final int HOUR_OF_DAY
        getysetEl número de campo representa la hora del día. HOUR_OF_DAYSe utiliza para el sistema de 24 horas. Por ejemplo, a las 10:04 p. m.:HOUR_OF_DAYes 22.
        Véase también:
        HOUR , Valores de campo constantes
      • MINUTE

        public static final int MINUTE
        getysetEl número de campo representa los minutos dentro de la hora. Por ejemplo, a las 10:04 p. m.:MINUTEes 4.
        Véase también:
        Valores de campo constantes
      • SECOND

        public static final int SECOND
        getysetEl número de campo representa el segundo dentro del minuto. Por ejemplo, a las 10:04 p. m.:SECONDes 15.
        Véase también:
        Valores de campo constantes
      • MILLISECOND

        public static final int MILLISECOND
        getysetEl número de campo representa los milisegundos dentro del segundo. Por ejemplo, a las 10:04 p. m.:MILLISECONDes 250.
        Véase también:
        Valores de campo constantes
      • ZONE_OFFSET

        public static final int ZONE_OFFSET
        getysetEl número de campo indica el desplazamiento bruto con respecto a GMT (en milisegundos).

        SiTimeZoneSi la subclase de implementación admite cambios históricos del desplazamiento GMT, este campo refleja elCalendarvalor correcto de desplazamiento GMT de esta zona horaria.

        Véase también:
        Valores de campo constantes
      • DST_OFFSET

        public static final int DST_OFFSET
        getysetNúmero de campo que indica el desplazamiento del horario de verano (en milisegundos).

        SiTimeZoneSi la subclase de implementación admite cambios históricos del horario de verano, este campo refleja elCalendarvalor correcto de desplazamiento por horario de verano de esta zona horaria.

        Véase también:
        Valores de campo constantes
      • FIELD_COUNT

        public static final int FIELD_COUNT
        getysetEl número de campos distintos reconocidos. El rango de números de campo va de0..FIELD_COUNT-1 。
        Véase también:
        Valores de campo constantes
      • JANUARY

        public static final int JANUARY
        MONTHEl valor del campo que representa el primer mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • FEBRUARY

        public static final int FEBRUARY
        MONTHValor del campo, que representa el segundo mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • MARCH

        public static final int MARCH
        MONTHEl valor del campo que representa el tercer mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • APRIL

        public static final int APRIL
        MONTHValor del campo, que representa el cuarto mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • MAY

        public static final int MAY
        MONTHEl valor del campo que representa el quinto mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • JUNE

        public static final int JUNE
        MONTHEl valor del campo que representa el sexto mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • JULY

        public static final int JULY
        MONTHEl valor del campo que representa el séptimo mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • AUGUST

        public static final int AUGUST
        MONTHValor del campo, que representa el octavo mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • SEPTEMBER

        public static final int SEPTEMBER
        MONTHEl valor del campo, que representa el noveno mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • OCTOBER

        public static final int OCTOBER
        MONTHEl valor del campo que representa el décimo mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • NOVEMBER

        public static final int NOVEMBER
        MONTHEl valor del campo que representa el undécimo mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • DECEMBER

        public static final int DECEMBER
        MONTHValor del campo, que representa el duodécimo mes del año en los calendarios gregoriano y juliano.
        Véase también:
        Valores de campo constantes
      • UNDECIMBER

        public static final int UNDECIMBER
        MONTHEl valor del campo, que representa el decimotercer mes del año. AunqueGregorianCalendarno usa este valor, pero el calendario lunar sí lo hace.
        Véase también:
        Valores de campo constantes
      • AM

        public static final int AM
        AM_PMValor del campo, que representa el período del día desde la medianoche hasta antes del mediodía.
        Véase también:
        Valores de campo constantes
      • PM

        public static final int PM
        AM_PMEl valor del campo que representa el período del día desde el mediodía hasta antes de la medianoche.
        Véase también:
        Valores de campo constantes
      • Campo

        protected int[] fields
        Los valores de los campos de calendario para la hora actualmente establecida de este calendario. Esta es unaFIELD_COUNTmatriz de enteros, cuyo valor de índice esERAllegarDST_OFFSET 。
      • isSet

        protected boolean[] isSet
        Indicador que indica si el campo especificado del calendario se ha establecido. El nuevo objeto no tiene campos establecidos. Después de la primera llamada a los métodos que generan los campos, todos permanecen establecidos a partir de entonces. Este es un conjuntoFIELD_COUNTValor booleano, cuyo valor de índice esERAllegarDST_OFFSET 。
      • time

        protected long time
        El tiempo establecido actualmente en este calendario, expresado en milisegundos transcurridos desde el 1 de enero de 1970, 00:00:00, hora estándar de Greenwich.
        Véase también:
        isTimeSet
      • isTimeSet

        protected boolean isTimeSet
        Si entoncestimeel valor es válidotimeVerdadero. Al cambiar el elementofield[]Invalidar el tiempo.
        Véase también:
        time
      • areFieldsSet

        protected boolean areFieldsSet
        Sifields[]sincronizado con la hora actualmente establecida,fields[] True。 Si es false, el próximo intento de obtener el valor del campo forzará el recálculo del valor actualtimede todos los campos.
    • Detalles de constructores

      • Calendar

        protected Calendar()
        Usando la zona horaria predeterminada y laFORMATconfiguración regional predeterminada para construir un calendario.
        Véase también:
        TimeZone.getDefault()
      • Calendar

        protected Calendar​(TimeZone zone,
                           Locale aLocale)
        Construye un calendario con la zona horaria y la configuración regional especificadas.
        Parámetros
        zone- Zona horaria a utilizar.
        aLocale- Configuración regional para los datos de la semana.
    • Detalles de métodos

      • getInstance

        public static Calendar getInstance()
        Obtener un calendario con la zona horaria y la configuración regional predeterminadas. El devueltoCalendarBasado en la hora actual en la zona horaria predeterminada, por defecto esFORMATlocale.

        Si el locale contiene la zona horaria 'tz'Unicode extensionentonces se usa esa zona horaria.

        Resultado
        Calendario.
      • getInstance

        public static Calendar getInstance​(TimeZone zone)
        Obtener un calendario con la zona horaria especificada y la configuración regional predeterminada. El devueltoCalendarbasado en la hora actual en la zona horaria dada, con el predeterminadoFORMATlocale.
        Parámetros
        zone- Zona horaria a utilizar.
        Resultado
        Calendario.
      • getInstance

        public static Calendar getInstance​(Locale aLocale)
        Obtener un calendario con la zona horaria predeterminada y la configuración regional especificada. El devueltoCalendarbasado en la hora actual en la zona horaria predeterminada con el locale dado.

        Si el locale contiene la zona horaria 'tz'Unicode extensionentonces se usa esa zona horaria.

        Parámetros
        aLocale- Configuración regional para los datos de la semana.
        Resultado
        Calendario.
      • getInstance

        public static Calendar getInstance​(TimeZone zone,
                                           Locale aLocale)
        Obtener un calendario con la zona horaria y la configuración regional especificadas. El devueltoCalendarbasado en la hora actual en la zona horaria dada con el locale dado.
        Parámetros
        zone- Zona horaria a utilizar.
        aLocale- Configuración regional para los datos de la semana.
        Resultado
        Calendario.
      • getAvailableLocales

        public static Locale[] getAvailableLocales()
        DevuelvegetInstanceEl método puede devolver una matriz de todos los locales de la instancia localizada. La matriz devuelta debe contener al menos un elemento igual aLocale.USdeLocaleinstancia.
        Resultado
        Un conjunto de configuraciones regionales, cuyas localizadasCalendarLa instancia está disponible.
      • computeFields

        protected abstract void computeFields()
        el valor de tiempo actual en milisegundos se convierte atimelos valores de los campos de calendariofields[] 。 Esto le permite sincronizar los valores de los campos del calendario con la nueva hora establecida para el calendario. horanorecalcular primero; recalcular la hora y luego los campos, llame acomplete()método.
        Véase también:
        computeTime()
      • getTime

        public final Date getTime()
        devuelve un objeto que representa esteCalendarel valor de tiempo (distanciade la épocadel desplazamiento en milisegundos)Dateobjeto.
        Resultado
        DateRepresenta un valor de tiempo.
        Véase también:
        setTime(Date) , getTimeInMillis()
      • setTime

        public final void setTime​(Date date)
        Usando el valor dadoDateEstablece el tiempo de este Calendar.

        Nota: el uso deDate(Long.MAX_VALUE)oDate(Long.MIN_VALUE)La llamadasetTime()puede, a partir deget()producir valores de campo incorrectos.

        Parámetros
        date- La fecha dada.
        Véase también:
        getTime() , setTimeInMillis(long)
      • getTimeInMillis

        public long getTimeInMillis()
        Devuelve el valor de tiempo de este Calendar en milisegundos.
        Resultado
        El tiempo actual en milisegundos UTC desde la época.
        Véase también:
        getTime() , setTimeInMillis(long)
      • setTimeInMillis

        public void setTimeInMillis​(long millis)
        Establece el tiempo actual de este Calendar a partir del valor long dado.
        Parámetros
        millis- Nuevo tiempo en milisegundos UTC desde la época.
        Véase también:
        setTime(Date) , getTimeInMillis()
      • get

        public int get​(int field)
        Devuelve el valor del campo de calendario dado. En modo indulgente, todos los campos del calendario se normalizan. En modo no indulgente, todos los campos del calendario se validan; si algún campo del calendario tiene un valor fuera de rango, este método lanzará una excepción. La normalización y validación porcomplete()El método procesa, este método depende del sistema de calendario.
        Parámetros
        campo- El campo de calendario dado.
        Resultado
        El valor del campo de calendario dado.
        Excepciones
        ArrayIndexOutOfBoundsException- Si el campo especificado está fuera de rango (field < 0 || field >= FIELD_COUNT )。
        Véase también:
        set(int,int) , complete()
      • internalGet

        protected final int internalGet​(int field)
        Devuelve el valor del campo de calendario dado. Este método no implica la normalización o validación de valores de campo.
        Parámetros
        campo- El campo de calendario dado.
        Resultado
        El valor del campo de calendario dado.
        Véase también:
        get(int)
      • set

        public void set​(int field,
                        int value)
        Establece el campo de calendario dado al valor dado. Independientemente del modo tolerante, este método no interpreta el valor.
        Parámetros
        campo- El campo de calendario dado.
        value- Valor a establecer para el campo de calendario dado.
        Excepciones
        ArrayIndexOutOfBoundsException- Si el campo especificado está fuera de rango (field < 0 || field >= FIELD_COUNT )。 en modo no tolerante.
        Véase también:
        set(int,int,int) , set(int,int,int,int,int) , set(int,int,int,int,int,int) , get(int)
      • set

        public final void set​(int year,
                              int month,
                              int date)
        Establece el valor del campo de calendarioYEAR , MONTHyDAY_OF_MONTH 。 Se conservan los valores anteriores de otros campos del calendario. Si no es necesario,por favor, primerollameclear() 。
        Parámetros
        year- Para establecerYEARel valor del campo de calendario.
        month- para establecerMONTHel valor del campo de calendario. El valor del mes se basa en 0. Por ejemplo, 0 representa enero.
        date- Para establecerDAY_OF_MONTHel valor del campo de calendario.
        Véase también:
        set(int,int) , set(int,int,int,int,int) , set(int,int,int,int,int,int)
      • set

        public final void set​(int year,
                              int month,
                              int date,
                              int hourOfDay,
                              int minute)
        Establece el valor del campo de calendarioYEAR , MONTH , DAY_OF_MONTH , HOUR_OF_DAYyMINUTE 。 Conserva los valores anteriores de otros campos. Si no es necesario,por favor, primerollameclear() 。
        Parámetros
        year- Para establecerYEARel valor del campo de calendario.
        month- para establecerMONTHel valor del campo de calendario. El valor del mes se basa en 0. Por ejemplo, 0 representa enero.
        date- Para establecerDAY_OF_MONTHel valor del campo de calendario.
        hourOfDay- Para establecerHOUR_OF_DAYel valor del campo de calendario.
        minute- Para establecerMINUTEel valor del campo de calendario.
        Véase también:
        set(int,int) , set(int,int,int) , set(int,int,int,int,int,int)
      • set

        public final void set​(int year,
                              int month,
                              int date,
                              int hourOfDay,
                              int minute,
                              int second)
        Establece el valor en el campoYEAR , MONTH , DAY_OF_MONTH , HOUR_OF_DAY , MINUTEySECOND 。 Conserva los valores anteriores de otros campos. Si no es necesario,por favor, primerollameclear() 。
        Parámetros
        year- Para establecerYEARel valor del campo de calendario.
        month- para establecerMONTHel valor del campo de calendario. El valor del mes se basa en 0. Por ejemplo, 0 representa enero.
        date- Para establecerDAY_OF_MONTHel valor del campo de calendario.
        hourOfDay- Para establecerHOUR_OF_DAYel valor del campo de calendario.
        minute- Para establecerMINUTEel valor del campo de calendario.
        second- Para establecerSECONDel valor del campo de calendario.
        Véase también:
        set(int,int) , set(int,int,int) , set(int,int,int,int,int)
      • clear

        public final void clear()
        Establece esteCalendarTodos los valores de campo de calendario y valores de tiempo no definidos (conde la épocael desplazamiento en milisegundos). Esto significa queisSet()se devolverá para todos los campos del calendariofalse, y los cálculos de fecha y hora tratan el campo como si nunca se hubiera establecido. CalendarLas clases de implementación pueden usar sus valores de campo predeterminados específicos para los cálculos de fecha/hora. Por ejemplo, siYEARel valor del campo no está definido, entoncesGregorianCalendarse utiliza 1970.
        Véase también:
        clear(int)
      • clear

        public final void clear​(int field)
        Establece esteCalendarlos valores dados de campo de calendario y de tiempo de undefined (distanciade la épocael desplazamiento en milisegundos). Esto significa queisSet(field)devolveráfalse, y el cálculo de fecha y hora trata ese campo como si nunca se hubiera establecido. CalendarLas clases de implementación pueden usar los valores predeterminados específicos del campo para el cálculo de fecha y hora.

        deHOUR_OF_DAY , HOURyAM_PMLos campos se procesan de forma independiente, ythe resolution rule for the time of dayse aplica. Limpiar uno de los campos no restablece esteCalendarel valor de la hora de. Usarset(Calendar.HOUR_OF_DAY, 0)Restablece el valor de la hora.

        Parámetros
        campo- El campo de calendario que se va a borrar.
        Véase también:
        clear()
      • isSet

        public final boolean isSet​(int field)
        Determina si un campo de calendario dado tiene un valor establecido, incluyendo porgetel caso de valores establecidos por cálculo de campo interno activado por llamadas a métodos.
        Parámetros
        campo- El campo de calendario que se va a probar.
        Resultado
        trueSi el campo de calendario dado tiene un valor establecido; de lo contrario,false 。
      • getDisplayName

        public String getDisplayName​(int field,
                                     int style,
                                     Locale locale)
        Devuelve elstyleylocalecalendariocampola representación de cadena del valorlocale 。 Si no hay una representación de cadena aplicable, devuelvenull 。 Si la representación de cadena es aplicable al calendario dadocampoentonces esta llamada al métodoget(field)para obtener el calendariocampovalores.

        Por ejemplo, si esteCalendarSíGregorianCalendary su fecha es 2005-01-01, entoncesMONTHla representación de cadena del campo será “January” en el estilo largo o “Jan” en el estilo corto en la configuración regional inglesa. Sin embargo,DAY_OF_MONTHel campo no tiene una representación de cadena disponible, este método devolveránull 。

        La implementación predeterminada admite los campos de calendario para los cualesDateFormatSymbolsen el nombre dadolocale 。

        Parámetros
        campo- El campo de calendario cuya representación de cadena se devuelve.
        style- el estilo aplicado a la representación de cadena; uno deSHORT_FORMAT ( SHORT ), SHORT_STANDALONE , LONG_FORMAT ( LONG ), LONG_STANDALONE , NARROW_FORMAT, oNARROW_STANDALONE 。
        locale- La configuración regional de la representación de cadena (localeCualquier tipo de calendario especificado será ignorado)
        Resultado
        dadocampoen lo dadostylerepresentación de cadenastyle, si no hay una representación de cadena aplicablestyle , null 。
        Excepciones
        IllegalArgumentException- sicampoostyleno válido, o esteCalendarNo es indulgente y cualquier campo de calendario tiene un valor no válido
        NullPointerException- silocaleestá vacío
        Desde la versión:
        1.6
      • getDisplayNames

        public Map<String,​Integer> getDisplayNames​(int field,
                                                         int style,
                                                         Locale locale)
        DevuelveMapque contiene el especificadostyleylocalecalendariocampotodos los nombres y sus valores de campo correspondientes. Por ejemplo, si esteCalendarSíGregorianCalendarentonces el mapa devuelto contendrá de “Jan” aJANUARY, “Feb” aFEBRUARY, y así sucesivamente, de la configuración regional inglesashorten los estilos.

        Debido al uso de un solo carácter, los nombres abreviados pueden no ser únicos, por ejemplo, la “S” de Sunday y Saturday. En este caso, los nombres abreviados no se incluyen en lo devuelto.Map 。

        Se pueden considerar los valores de otros campos de calendario para determinar un conjunto de nombres para mostrar. Por ejemplo, si esteCalendares un sistema lunisolar yYEARel valor del año dado por el campo tiene un mes intercalar, entonces este método devolverá nombres de meses que incluyen el nombre del mes intercalar, y los nombres de meses se asignarán a nombres de meses específicos del año.

        La implementación predeterminada admiteDateFormatSymbolsMediolos nombres para mostrar incluidos. Por ejemplo, sicampoSíMONTHystyleSíALL_STYLES, entonces este método devuelveMapque contieneDateFormatSymbols.getShortMonths()yDateFormatSymbols.getMonths()todas las cadenas devueltas.

        Parámetros
        campo- El campo de calendario cuyo nombre para mostrar se devuelve.
        style- el estilo aplicado a la representación de cadena; uno deSHORT_FORMAT ( SHORT ), SHORT_STANDALONE , LONG_FORMAT ( LONG ), LONG_STANDALONE , NARROW_FORMAT, oNARROW_STANDALONE
        locale- La configuración regional para el nombre para mostrar.
        Resultado
        unMapincluidas en todos los nombres para mostrarstyleylocaley sus valores de campo, onullsi no hay nombres para mostrar definidoscampo
        Excepciones
        IllegalArgumentException- sicampoostyleno válido, o esteCalendarNo es indulgente y cualquier campo de calendario tiene un valor no válido
        NullPointerException- silocaleestá vacío
        Desde la versión:
        1.6
      • complete

        protected void complete()
        Rellene cualquier campo no establecido en los campos de calendario. Primero, si el valor de tiempo aún no se ha calculado según los valores de los campos de calendario (el desplazamientode la épocaen milisegundos), entonces se llamacomputeTime()método. Luego, llame alcomputeFields()método para calcular todos los valores de los campos del calendario.
      • getAvailableCalendarTypes

        public static Set<String> getAvailableCalendarTypes()
        Devuelve un objeto inmutableSetque contiene en el entorno de ejecuciónCalendartodos los tipos de calendario admitidos. Los tipos de calendario disponibles se pueden usar paraUnicode locale extensions 。 El devueltoSetcontener al menos"gregory" 。 El tipo de calendario no contiene alias, por ejemplo,"gregorian" ( "gregory" 。
        Resultado
        Un conjunto no modificable que contiene todos los tipos de calendario disponiblesSet
        Desde la versión:
        1.8
        Véase también:
        getCalendarType() , Calendar.Builder.setCalendarType(String) , Locale.getUnicodeLocaleType(String)
      • getCalendarType

        public String getCalendarType()
        Devuelve esteCalendardel tipo de calendario. El tipo de calendario está definidoLenguaje de Marcado de Datos de Configuración Regional Unicode (LDML)por la especificación.

        La implementación predeterminada de este método devuelve elCalendarnombre de clase de esta instancia. Cualquier subclase que implemente un sistema de calendario definido por LDML debe anular este método para devolver el tipo de calendario apropiado.

        Resultado
        el tipo de calendario definido por LDML o esteCalendarEl nombre de clase de la instancia
        Desde la versión:
        1.8
        Véase también:
        Locale extensions , Locale.Builder.setLocale(Locale) , Locale.Builder.setUnicodeLocaleKeyword(String, String)
      • equals

        public boolean equals​(Object obj)
        estoCalendarcon el especificadoObject 。 si y solo si el argumento es del mismo sistema de calendarioCalendarcuando es un objeto, el resultado estrue, el objeto representa lo mismo que este objetoCalendarel mismo valor de tiempo bajo los parámetros (distanciade la épocadesplazamiento en milisegundos).

        deCalendarel parámetro es el valor representado porisLenient , getFirstDayOfWeek , getMinimalDaysInFirstWeekygetTimeZonemétodo. Si los dosCalendartienen alguna diferencia en los parámetros entre ellos, este método devuelvefalse 。

        UsarcompareToEl método solo compara valores de tiempo.

        Sobrescribe:
        equalsClaseObject
        Parámetros
        obj- El objeto con el que se va a comparar.
        Resultado
        trueSi este objeto es igual aobj ; de lo contrario,false 。
        Véase también:
        Object.hashCode() , HashMap
      • before

        public boolean before​(Object when)
        Devuelve esteCalendarSi representa lo especificadoObjectel tiempo anterior al tiempo representado. Este método equivale a:
           compareTo(when) < 0  
        si y solo siwhenSíCalendarcuando es una instancia. De lo contrario, este método devuelvefalse 。
        Parámetros
        when- el objeto a compararObject
        Resultado
        truesi este tiempoCalendares anterior al tiempo representado por la siguiente fórmula.when ; de lo contrario,false 。
        Véase también:
        compareTo(Calendar)
      • after

        public boolean after​(Object when)
        Devuelve esteCalendarSi representa lo especificadoObjectEl tiempo posterior al tiempo representado. Este método equivale a:
           compareTo(when) > 0  
        si y solo siwhenSíCalendarcuando es una instancia. De lo contrario, este método devuelvefalse 。
        Parámetros
        when- el objeto a compararObject
        Resultado
        trueSi elCalendartiempo de estewhenquewhenel tiempo representado; de lo contrario,false 。
        Véase también:
        compareTo(Calendar)
      • compareTo

        public int compareTo​(Calendar anotherCalendar)
        Compara dosCalendarEl valor de tiempo representado por el objeto (desdeel inicio de Epochdesplazamiento en milisegundos).
        Specified by:
        compareTo in interface Comparable<Calendar>
        Parámetros
        anotherCalendar- el objeto a compararCalendar 。
        Resultado
        Valor0Si el tiempo representado por el argumento es igual al tiempo representado por esteCalendar ; Si elCalendarEl tiempo es anterior al tiempo representado por el argumento, entonces el valor es menor que0 ; Si elCalendarEl tiempo es posterior al tiempo representado por el argumento, entonces el valor es mayor que0 。
        Excepciones
        NullPointerException- Si el especificadoCalendarSínull 。
        IllegalArgumentException- Si el especificado no se puede obtener debido a cualquier valor de calendario no válidoCalendarvalor de tiempo del objeto.
        Desde la versión:
        1.5
      • add

        public abstract void add​(int field,
                                 int amount)
        Añade o resta la cantidad de tiempo especificada al campo de calendario dado, según las reglas del calendario. Por ejemplo, para restar 5 días a la hora actual del calendario, puede hacerlo llamando al siguiente método:

        add(Calendar.DAY_OF_MONTH, -5) 。

        Parámetros
        campo- Campo de calendario.
        amount- Cantidad de fecha u hora a agregar al campo.
        Véase también:
        roll(int,int) , set(int,int)
      • roll

        public abstract void roll​(int field,
                                  boolean up)
        Añade o resta (hacia arriba/abajo) una única unidad de tiempo en un campo de tiempo dado sin cambiar los campos mayores. Por ejemplo, para adelantar un día la fecha actual, puede hacerlo de la siguiente manera:

        roll(Calendar.DATE,true)。 Al desplazarse sobre el campo de año o Calendar.YEAR, desplazará el valor del año, en un rango entre 1 ygetMaximum(Calendar.YEAR)el valor devuelto por la llamada. Al desplazarse sobre el campo de mes o Calendar.MONTH, otros campos (como la fecha) pueden entrar en conflicto y deben cambiarse. Por ejemplo, al desplazar el mes en la fecha 01/31/96 se obtiene 02/29/96. Al desplazarse sobre el campo de hora o Calendar.HOUR_OF_DAY, desplazará el valor de la hora en un rango entre 0 y 23, comenzando desde cero.

        Parámetros
        campo- Campo de tiempo.
        up- Indica si se debe agregar o desplazar el valor del campo de tiempo especificado. Utilice true si se desplaza; de lo contrario, utilice false.
        Véase también:
        add(int,int) , set(int,int)
      • roll

        public void roll​(int field,
                         int amount)
        Añade la cantidad (con signo) especificada al campo de calendario especificado, sin cambiar los campos mayores. Un número negativo indica un desplazamiento hacia abajo.

        Nota:CalendarLa implementación predeterminada de este método solo repite la llamada a la versión que desplaza en una unidad.roll() 。 Esto puede no siempre hacer lo correcto. Por ejemplo, siDAY_OF_MONTHSi el campo es 31, al desplazarse a febrero se establece en 28. La versión de esta funciónGregorianCalendarpuede resolver este problema. Otras subclases también deben proporcionar una sobrescritura de esta función para hacer lo correcto.

        Parámetros
        campo- Campo de calendario.
        amount- El valor a añadir al calendario.campode la cantidad con signo.
        Desde la versión:
        1.2
        Véase también:
        roll(int,boolean) , add(int,int) , set(int,int)
      • setTimeZone

        public void setTimeZone​(TimeZone value)
        Establece la zona horaria con el valor de zona horaria dado.
        Parámetros
        value- La zona horaria dada.
      • getTimeZone

        public TimeZone getTimeZone()
        Obtiene la zona horaria.
        Resultado
        El objeto de zona horaria asociado a este calendario.
      • setLenient

        public void setLenient​(boolean lenient)
        Especifica si la interpretación de fecha/hora es tolerante. Mediante una interpretación permisiva, fechas como “942 de febrero de 1996” se tratarán como equivalentes al día 941 después del 1 de febrero de 1996. Mediante una interpretación estricta (no permisiva), tales fechas provocarán que se lance una excepción. El valor predeterminado es permisivo.
        Parámetros
        lenient - trueSi se desea activar el modo permisivo; falseSi se debe desactivar.
        Véase también:
        isLenient() , DateFormat.setLenient(boolean)
      • isLenient

        public boolean isLenient()
        Indica si la interpretación de fecha/hora es tolerante.
        Resultado
        trueSi el modo de interpretación de este calendario es permisivo; de lo contrario,false 。
        Véase también:
        setLenient(boolean)
      • setFirstDayOfWeek

        public void setFirstDayOfWeek​(int value)
        Establece cuál es el primer día de la semana; Por ejemplo,SUNDAYEn los Estados Unidos,MONDAYen Francia.
        Parámetros
        value- El primer día de la semana.
        Véase también:
        getFirstDayOfWeek() , getMinimalDaysInFirstWeek()
      • getFirstDayOfWeek

        public int getFirstDayOfWeek()
        Obtener cuál es el primer día de la semana; Por ejemplo,SUNDAYEn los Estados Unidos,MONDAYen Francia.
        Resultado
        El primer día de la semana.
        Véase también:
        setFirstDayOfWeek(int) , getMinimalDaysInFirstWeek()
      • setMinimalDaysInFirstWeek

        public void setMinimalDaysInFirstWeek​(int value)
        Establece el número mínimo de días requerido para la primera semana del año; Por ejemplo, si la primera semana se define como la semana que contiene el primer día del primer mes del año, este método se invoca con el valor 1. Si debe ser una semana completa, se utiliza el valor 7.
        Parámetros
        value- Número mínimo de días requeridos para la primera semana del año.
        Véase también:
        getMinimalDaysInFirstWeek()
      • getMinimalDaysInFirstWeek

        public int getMinimalDaysInFirstWeek()
        Obtener el número mínimo de días necesario para la primera semana del año; Por ejemplo, si la primera semana se define como la semana que contiene el primer día del primer mes del año, este método devuelve 1. Si los días mínimos requeridos deben constituir una semana completa, este método devuelve 7.
        Resultado
        El número mínimo de días requerido para la primera semana del año.
        Véase también:
        setMinimalDaysInFirstWeek(int)
      • isWeekDateSupported

        public boolean isWeekDateSupported()
        Devuelve esteCalendarSi se admiten fechas semanales.

        La implementación predeterminada de este método devuelvefalse 。

        Resultado
        trueSi esteCalendaradmite fechas semanales; de lo contrario,false 。
        Desde la versión:
        1.7
        Véase también:
        getWeekYear() , setWeekDate(int,int,int) , getWeeksInWeekYear()
      • setWeekDate

        public void setWeekDate​(int weekYear,
                                int weekOfYear,
                                int dayOfWeek)
        Establece esto usando el especificador de fecha dadoCalendarde la fecha: año semanal, semana y día de la semana.

        ysetel método es diferente; todos los campos del calendario ytimelos valores se calculan cuando se devuelven.

        SiweekOfYearfuera del rango de años semanales válidosweekYear, dichoweekYearunidadweekOfYearvalor se ajusta en el modo permisivo, oIllegalArgumentExceptionen el modo no permisivo se lanza una excepción.

        La implementación predeterminada de este método lanzaUnsupportedOperationException 。

        Parámetros
        weekYear- El año de esta semana
        weekOfYear- Este número de semana se basa enweekYear
        dayOfWeek- Valor del día de la semana:DAY_OF_WEEKUna de las constantes de campo:SUNDAY ,..., SATURDAY 。
        Excepciones
        IllegalArgumentException- Si cualquier especificador de fecha dado es inválido o cualquier campo de calendario es inconsistente con el especificador de fecha dado en modo no indulgente
        UnsupportedOperationException- Si esteCalendarNo se admite ninguna numeración de año semanal.
        Desde la versión:
        1.7
        Véase también:
        isWeekDateSupported() , getFirstDayOfWeek() , getMinimalDaysInFirstWeek()
      • getWeeksInWeekYear

        public int getWeeksInWeekYear()
        Devuelve esteCalendarlas semanas en el año semanal representadoCalendar 。

        La implementación predeterminada de este método lanzaUnsupportedOperationException 。

        Resultado
        El número de la semana dentro de una semana.
        Excepciones
        UnsupportedOperationException- Si esteCalendarNo se admite ninguna numeración de año semanal.
        Desde la versión:
        1.7
        Véase también:
        WEEK_OF_YEAR , isWeekDateSupported() , getWeekYear() , getActualMaximum(int)
      • getMinimum

        public abstract int getMinimum​(int field)
        Devuelve esteCalendardel campo de calendario dado de la instanciaCalendar 。 el mínimo se define comogetel valor mínimo que el método devuelve para cualquier valor de tiempo posible. El valor mínimo depende de los parámetros específicos del sistema de calendario de la instancia.
        Parámetros
        campo- Campo de calendario.
        Resultado
        El valor mínimo para el campo de calendario dado.
        Véase también:
        getMaximum(int) , getGreatestMinimum(int) , getLeastMaximum(int) , getActualMinimum(int) , getActualMaximum(int)
      • getMaximum

        public abstract int getMaximum​(int field)
        Devuelve esteCalendardel campo de calendario dado de la instanciaCalendar 。 El valor máximo se define comogetEl valor máximo devuelto por el método para cualquier valor de tiempo posible. El valor máximo depende de los parámetros específicos del sistema de calendario de la instancia.
        Parámetros
        campo- Campo de calendario.
        Resultado
        El valor máximo para el campo de calendario dado.
        Véase también:
        getMinimum(int) , getGreatestMinimum(int) , getLeastMaximum(int) , getActualMinimum(int) , getActualMaximum(int)
      • getGreatestMinimum

        public abstract int getGreatestMinimum​(int field)
        Devuelve esteCalendarel valor mínimo más alto del campo de calendario dado de la instancia. El mínimo más alto se define comogetActualMinimum(int)El valor máximo devuelto para cualquier valor de tiempo posible. El mayor mínimo depende de los parámetros específicos del sistema de calendario de la instancia.
        Parámetros
        campo- Campo de calendario.
        Resultado
        El valor mínimo mínimo para el campo de calendario dado.
        Véase también:
        getMinimum(int) , getMaximum(int) , getLeastMaximum(int) , getActualMinimum(int) , getActualMaximum(int)
      • getLeastMaximum

        public abstract int getLeastMaximum​(int field)
        Devuelve esteCalendarel valor máximo más bajo del campo de calendario dado de la instancia. El valor máximo más bajo se define comogetActualMaximum(int)El valor devuelto para cualquier valor de tiempo posible.Valor mínimo 。 El valor mínimo mínimo depende de los parámetros específicos del sistema de calendario de la instancia. Por ejemplo,CalendarPara el sistema de calendario gregoriano se devuelve 28DAY_OF_MONTHEn el campo, ya que el día 28 es el último día del mes más corto, febrero, en un año común en este calendario.
        Parámetros
        campo- Campo de calendario.
        Resultado
        El valor máximo mínimo para el campo de calendario dado.
        Véase también:
        getMinimum(int) , getMaximum(int) , getGreatestMinimum(int) , getActualMinimum(int) , getActualMaximum(int)
      • getActualMinimum

        public int getActualMinimum​(int field)
        dado esteCalendardel valor de tiempo, devuelve el valor que el campo de calendario especificado puede tenerCalendar 。

        La implementación predeterminada de este método utiliza un algoritmo iterativo para determinar el valor mínimo real del campo de calendario. Si es posible, las subclases deberían sobrescribirlo con una implementación más eficiente; en muchos casos, pueden simplemente devolvergetMinimum() 。

        Parámetros
        campo- Campo de calendario
        Resultado
        EsteCalendardel valor de tiempo del campo de calendario dado.Calendar
        Desde la versión:
        1.2
        Véase también:
        getMinimum(int) , getMaximum(int) , getGreatestMinimum(int) , getLeastMaximum(int) , getActualMaximum(int)
      • getActualMaximum

        public int getActualMaximum​(int field)
        dado esteCalendardel valor de tiempo, devuelve el valor que el campo de calendario especificado puede tenerCalendar 。 Por ejemplo,MONTHEl valor máximo real del campo es 12 en algunos años y 13 en otros años en el sistema de calendario hebreo.

        La implementación predeterminada de este método utiliza un algoritmo iterativo para determinar el valor máximo real del campo de calendario. Si es posible, las subclases deberían sobrescribirlo con una implementación más eficiente.

        Parámetros
        campo- Campo de calendario
        Resultado
        EsteCalendardel valor de tiempo del campo de calendario dado.Calendar
        Desde la versión:
        1.2
        Véase también:
        getMinimum(int) , getMaximum(int) , getGreatestMinimum(int) , getLeastMaximum(int) , getActualMinimum(int)
      • clone

        public Object clone()
        Crea y devuelve una copia de este objeto.
        Sobrescribe:
        cloneEn la claseObject
        Resultado
        Una copia de este objeto.
        Véase también:
        Cloneable
      • toString

        public String toString()
        Devuelve la representación de cadena de este calendario. Este método se utiliza únicamente con fines de depuración; el formato de la cadena devuelta puede variar según la implementación. La cadena devuelta puede estar vacía, pero no puede ser nula.null 。
        Sobrescribe:
        toStringEn el curso.Object
        Resultado
        La representación de cadena de este calendario.
      • toInstant

        public final Instant toInstant()
        Convierte este objeto aInstant 。

        La conversión crea unInstant, que representa en la línea de tiempo con esteCalendarel mismo punto.

        Resultado
        Un instante que representa el mismo punto en la línea de tiempo.
        Desde la versión:
        1.8