- java.lang.Object
-
- java.util.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 como
protected。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 al
setmé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.Cuando
CalendarCuando 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 obtener
WEEK_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,
Calendargives 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 time of day 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
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, entonces
Calendarse 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:
- 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.
- 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. Usar
DateFormatFormatear 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: Considere
GregorianCalendarinicialmente 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
fafter the call minus the value of fieldfbefore the call isdelta, modulo any overflow that has occurred in fieldf. 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
fis 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.HOURis a smaller field thanDAY_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, con
set()diferente,add()obliga a recalcular inmediatamente los milisegundos del calendario y todos los campos.Por ejemplo: Considere
GregorianCalendarinicialmente 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_MONTHis a larger field thanHOUR.Ejemplo: consulte
GregorianCalendar.roll(int, int)。patrón de uso 。 Para provocar
add()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 classCalendar.BuilderCalendar.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 intALL_STYLESgetDisplayNamesEl especificador de estilo, que indica los nombres en todos los estilos, por ejemplo, “January” y “Jan”.static intAMAM_PMValor del campo, que representa el período del día desde la medianoche hasta antes del mediodía.static intAM_PMgetysetEl número de campo indicaHOURsi es antes o después del mediodía.static intAPRILMONTHValor del campo, que representa el cuarto mes del año en los calendarios gregoriano y juliano.protected booleanareFieldsSetSifields[]sincronizado con la hora actualmente establecida,fields[]True。static intAUGUSTMONTHValor del campo, que representa el octavo mes del año en los calendarios gregoriano y juliano.static intDATEgetysetEl número de campo indica el día del mes.static intDAY_OF_MONTHgetysetEl número de campo indica el día del mes.static intDAY_OF_WEEKEl número de campogetysetindica el día de la semana.static intDAY_OF_WEEK_IN_MONTHgetysetNúmero de campo, que indica el ordinal de un día en el mes actual.static intDAY_OF_YEARgetysetEl número de campo indica el número de día del año.static intDECEMBERMONTHValor del campo, que representa el duodécimo mes del año en los calendarios gregoriano y juliano.static intDST_OFFSETgetysetNúmero de campo que indica el desplazamiento del horario de verano (en milisegundos).static intERAgetysetEl número de campo indica la era, por ejemplo, AD o BC en el calendario juliano.static intFEBRUARYMONTHValor del campo, que representa el segundo mes del año en los calendarios gregoriano y juliano.static intFIELD_COUNTgetysetEl número de campos distintos reconocidos.protected int[]campoLos valores de los campos de calendario para la hora actualmente establecida de este calendario.static intFRIDAYDAY_OF_WEEKEl valor del campo representa el viernes.static intHOURgetysetEl número de campo representa la hora de la mañana o de la tarde.static intHOUR_OF_DAYgetysetEl número de campo representa la hora del día.protected boolean[]isSetIndicador que indica si el campo especificado del calendario se ha establecido.protected booleanisTimeSetSi entoncestimeel valor es válidotimeVerdadero.static intJANUARYMONTHEl valor del campo que representa el primer mes del año en los calendarios gregoriano y juliano.static intJULYMONTHEl valor del campo que representa el séptimo mes del año en los calendarios gregoriano y juliano.static intJUNEMONTHEl valor del campo que representa el sexto mes del año en los calendarios gregoriano y juliano.static intLONGstatic intLONG_FORMATgetDisplayNameygetDisplayNamesdeDescripción del estilocarácter, indica el nombre largo utilizado para el formato.static intLONG_STANDALONEgetDisplayNameygetDisplayNamesdeDescripció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 intMARCHMONTHEl valor del campo que representa el tercer mes del año en los calendarios gregoriano y juliano.static intMAYMONTHEl valor del campo que representa el quinto mes del año en los calendarios gregoriano y juliano.static intMILLISECONDgetysetEl número de campo representa los milisegundos dentro del segundo.static intMINUTEgetysetEl número de campo representa los minutos dentro de la hora.static intMONDAYDAY_OF_WEEKEl valor del campo representa el lunes.static intMONTHgetysetEl número de campo representa el mes.static intNARROW_FORMATgetDisplayNameygetDisplayNamesdeDescripción del estilocarácter, indica el nombre estrecho utilizado para el formato.static intNARROW_STANDALONEgetDisplayNameygetDisplayNamesdeDescripción del estilocarácter , independienteIndica el nombre estrecho.static intNOVEMBERMONTHEl valor del campo que representa el undécimo mes del año en los calendarios gregoriano y juliano.static intOCTOBERMONTHEl valor del campo que representa el décimo mes del año en los calendarios gregoriano y juliano.static intPMAM_PMEl valor del campo que representa el período del día desde el mediodía hasta antes de la medianoche.static intSATURDAYQue representa el sábado.DAY_OF_WEEKEl valor del campo.static intSECONDgetysetEl número de campo representa el segundo dentro del minuto.static intSEPTEMBERMONTHEl valor del campo, que representa el noveno mes del año en los calendarios gregoriano y juliano.static intSHORTstatic intSHORT_FORMATgetDisplayNameygetDisplayNamesdeDescripción del estilocarácter, indica los nombres cortos utilizados para dar formato.static intSHORT_STANDALONEgetDisplayNameygetDisplayNamesdeDescripción del estilocarácter, indica los nombres cortos de uso independiente, por ejemplo, las abreviaturas de los meses como títulos de calendario.static intSUNDAYQue representa el domingo.DAY_OF_WEEKEl valor del campo.static intTHURSDAYDAY_OF_WEEKEl valor del campo representa el jueves.protected longtimeEl 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 intTUESDAYQue representa el martes.DAY_OF_WEEKEl valor del campo.static intUNDECIMBERMONTHEl valor del campo, que representa el decimotercer mes del año.static intWEDNESDAYDAY_OF_WEEKEl valor del campo representa el miércoles.static intWEEK_OF_MONTHgetysetEl número de campo,getsetEl número de la semana.static intWEEK_OF_YEARgetysetEl número de campo representa el número de semana del año actual.static intYEAREl número de campogetysetRepresenta el año.static intZONE_OFFSETgetysetEl número de campo, que representa el desplazamiento original respecto de GMT (en milisegundos).
-
Resumen de constructores
Método constructor Variable Constructor Descripción protectedCalendar()Usando la zona horaria predeterminada y laFORMATconfiguración regional predeterminada para construir un calendario.protectedCalendar(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 voidadd(int field, int amount)Añade o resta la cantidad de tiempo especificada al campo de calendario dado, según las reglas del calendario.booleanafter(Object when)Devuelve esteCalendarSi representa lo especificadoObjectEl tiempo posterior al tiempo representado.booleanbefore(Object when)Devuelve esteCalendarSi representa lo especificadoObjectEl tiempo anterior al tiempo representado.voidclear()Establece esteCalendarTodos los valores de los campos del calendario y el valor de tiempo sin definir (la distancia desdede la épocael desplazamiento en milisegundos).voidclear(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).Objectclone()Crea y devuelve una copia de este objeto.intcompareTo(Calendar anotherCalendar)Compara dosCalendarEl valor de tiempo representado por el objeto (desdeel inicio de Epochdesplazamiento en milisegundos).protected voidcomplete()Rellene cualquier campo no establecido en los campos de calendario.protected abstract voidcomputeFields()protected abstract voidcomputeTime()va afields[]Medioel valor actual del campo de calendarioconvertira un valor de tiempo en milisegundostime。booleanequals(Object obj)estoCalendarcon el especificadoObject。intget(int field)Devuelve el valor del campo de calendario dado.intgetActualMaximum(int field)dado esteCalendardel valor de tiempo, devuelve el valor que el campo de calendario especificado puede tenerCalendar。intgetActualMinimum(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.StringgetCalendarType()Devuelve esteCalendardel tipo de calendario.StringgetDisplayName(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.intgetFirstDayOfWeek()Obtener cuál es el primer día de la semana; Por ejemplo,SUNDAYEn los Estados Unidos,MONDAYen Francia.abstract intgetGreatestMinimum(int field)Devuelve esteCalendarel valor mínimo más alto del campo de calendario dado de la instancia.static CalendargetInstance()Obtener un calendario con la zona horaria y la configuración regional predeterminadas.static CalendargetInstance(Locale aLocale)Obtener un calendario con la zona horaria predeterminada y la configuración regional especificada.static CalendargetInstance(TimeZone zone)Obtener un calendario con la zona horaria especificada y la configuración regional predeterminada.static CalendargetInstance(TimeZone zone, Locale aLocale)Obtener un calendario con la zona horaria y la configuración regional especificadas.abstract intgetLeastMaximum(int field)Devuelve esteCalendarel valor máximo más bajo del campo de calendario dado de la instancia.abstract intgetMaximum(int field)Devuelve esteCalendardel campo de calendario dado de la instanciaCalendar。intgetMinimalDaysInFirstWeek()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 intgetMinimum(int field)Devuelve esteCalendardel campo de calendario dado de la instanciaCalendar。DategetTime()Devuelve unDateobjeto que representa esteCalendarel valor de tiempo (distanciade la épocael desplazamiento en milisegundos).longgetTimeInMillis()Devuelve el valor de tiempo de este Calendar en milisegundos.TimeZonegetTimeZone()Obtiene la zona horaria.intgetWeeksInWeekYear()Devuelve esteCalendarla semana de la semana representadaCalendar。intgetWeekYear()Devuelve esteCalendarrepresentadoCalendar。inthashCode()Devuelve el código hash de este calendario.protected intinternalGet(int field)Devuelve el valor del campo de calendario dado.booleanisLenient()Indica si la interpretación de fecha/hora es tolerante.booleanisSet(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.booleanisWeekDateSupported()Devuelve esteCalendarSi se admiten fechas semanales.abstract voidroll(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.voidroll(int field, int amount)Añade la cantidad (con signo) especificada al campo de calendario especificado, sin cambiar los campos mayores.voidset(int field, int value)Establece el campo de calendario dado al valor dado.voidset(int year, int month, int date)Establece el valor del campo de calendarioYEAR,MONTHyDAY_OF_MONTH。voidset(int year, int month, int date, int hourOfDay, int minute)Establece el valor del campo de calendarioYEAR,MONTH,DAY_OF_MONTH,HOUR_OF_DAYyMINUTE。voidset(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。voidsetFirstDayOfWeek(int value)Establece cuál es el primer día de la semana; Por ejemplo,SUNDAYEn los Estados Unidos,MONDAYen Francia.voidsetLenient(boolean lenient)Especifica si la interpretación de fecha/hora es tolerante.voidsetMinimalDaysInFirstWeek(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.voidsetTime(Date date)Usando el valor dadoDateEstablece el tiempo de este Calendar.voidsetTimeInMillis(long millis)Establece el tiempo actual de este Calendar a partir del valor long dado.voidsetTimeZone(TimeZone value)Establece la zona horaria con el valor de zona horaria dado.voidsetWeekDate(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.InstanttoInstant()Convierte este objeto aInstant。StringtoString()Devuelve la representación de cadena de este calendario.
-
-
-
Detalles de campos
-
ERA
public static final int ERA
getysetEl número de campo indica la era, por ejemplo, AD o BC en el calendario juliano. Este es un valor específico del calendario; Consulte la documentación de la subclase.- Véase también:
-
GregorianCalendar.AD,GregorianCalendar.BC, Valores de campo constantes
-
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
-
MONTH
public static final int MONTH
getysetEl número de campo representa el mes. Este es un valor específico del calendario. El primer mes en los calendarios gregoriano y juliano esJANUARY, es decir, 0; El último depende del número de meses del año.
-
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
public static final int DAY_OF_WEEK
getysetEl número de campo representa el día de la semana. El valor de este campoSUNDAY,MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAYySATURDAY。
-
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).Si
TimeZoneSi 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).Si
TimeZoneSi 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
-
SUNDAY
public static final int SUNDAY
Que representa el domingo.DAY_OF_WEEKEl valor del campo.- Véase también:
- Valores de campo constantes
-
MONDAY
public static final int MONDAY
DAY_OF_WEEKEl valor del campo representa el lunes.- Véase también:
- Valores de campo constantes
-
TUESDAY
public static final int TUESDAY
Que representa el martes.DAY_OF_WEEKEl valor del campo.- Véase también:
- Valores de campo constantes
-
WEDNESDAY
public static final int WEDNESDAY
DAY_OF_WEEKEl valor del campo representa el miércoles.- Véase también:
- Valores de campo constantes
-
THURSDAY
public static final int THURSDAY
DAY_OF_WEEKEl valor del campo representa el jueves.- Véase también:
- Valores de campo constantes
-
FRIDAY
public static final int FRIDAY
el que representa el viernesDAY_OF_WEEKEl valor del campo.- Véase también:
- Valores de campo constantes
-
SATURDAY
public static final int SATURDAY
Que representa el sábado.DAY_OF_WEEKEl valor del campo.- 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
-
ALL_STYLES
public static final int ALL_STYLES
getDisplayNamesEl especificador de estilo que representa los nombres de todos los estilos, por ejemplo 'January' y 'Jan'.- Desde la versión:
- 1.6
- Véase también:
-
SHORT_FORMAT,LONG_FORMAT,SHORT_STANDALONE,LONG_STANDALONE,SHORT,LONG, Valores de campo constantes
-
SHORT
public static final int SHORT
- Desde la versión:
- 1.6
- Véase también:
-
SHORT_STANDALONE,LONG, Valores de campo constantes
-
LONG
public static final int LONG
- Desde la versión:
- 1.6
- Véase también:
-
LONG_STANDALONE,SHORT, Valores de campo constantes
-
NARROW_FORMAT
public static final int NARROW_FORMAT
getDisplayNameygetDisplayNamesdeDescripción del estilocarácter, indica el nombre estrecho utilizado para el formato. Los nombres reducidos suelen ser una sola cadena, por ejemplo 'M' para el lunes.- Desde la versión:
- 1.8
- Véase también:
-
NARROW_STANDALONE,SHORT_FORMAT,LONG_FORMAT, Valores de campo constantes
-
NARROW_STANDALONE
public static final int NARROW_STANDALONE
getDisplayNameygetDisplayNamesdeDescripción del estilocarácter , independienteIndica el nombre estrecho. Los nombres reducidos suelen ser una sola cadena, por ejemplo 'M' para el lunes.- Desde la versión:
- 1.8
- Véase también:
-
NARROW_FORMAT,SHORT_STANDALONE,LONG_STANDALONE, Valores de campo constantes
-
SHORT_FORMAT
public static final int SHORT_FORMAT
getDisplayNameygetDisplayNamesdeDescripción del estilocarácter, indica los nombres cortos utilizados para dar formato.- Desde la versión:
- 1.8
- Véase también:
-
SHORT_STANDALONE,LONG_FORMAT,LONG_STANDALONE, Valores de campo constantes
-
LONG_FORMAT
public static final int LONG_FORMAT
getDisplayNameygetDisplayNamesdeDescripción del estilocarácter, indica el nombre largo utilizado para el formato.- Desde la versión:
- 1.8
- Véase también:
-
LONG_STANDALONE,SHORT_FORMAT,SHORT_STANDALONE, Valores de campo constantes
-
SHORT_STANDALONE
public static final 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.- Desde la versión:
- 1.8
- Véase también:
-
SHORT_FORMAT,LONG_FORMAT,LONG_STANDALONE, Valores de campo constantes
-
LONG_STANDALONE
public static final 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.- Desde la versión:
- 1.8
- Véase también:
-
LONG_FORMAT,SHORT_FORMAT,SHORT_STANDALONE, 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()
-
-
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 localizadas
CalendarLa instancia está disponible.
-
computeTime
protected abstract void computeTime()
va afields[]Medioel valor actual del campo de calendarioconvertira un valor de tiempo en milisegundostime。- Véase también:
-
complete(),computeFields()
-
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 de
Date(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.de
HOUR_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 este
CalendarSí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 cuales
DateFormatSymbolsen 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
- dado
campoen 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 este
Calendares 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 admite
DateFormatSymbolsMediolos 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
- un
Mapincluidas 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 disponibles
Set - 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 el
Calendarnombre 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 este
CalendarEl 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).de
Calendarel 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。Usar
compareToEl 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
-
hashCode
public int hashCode()
Devuelve el código hash de este calendario.- Sobrescribe:
-
hashCode, la claseObject - Resultado
- El valor del código hash de este objeto.
- Desde la versión:
- 1.2
- Véase también:
-
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
before
public boolean before(Object when)
Devuelve esteCalendarSi representa lo especificadoObjectel tiempo anterior al tiempo representado. Este método equivale a:si y solo sicompareTo(when) < 0whenSí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:si y solo sicompareTo(when) > 0whenSí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:
-
compareToin interfaceComparable<Calendar> - Parámetros
-
anotherCalendar- el objeto a compararCalendar。 - Resultado
-
Valor
0Si 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 y
getMaximum(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 devuelve
false。- 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()
-
getWeekYear
public int getWeekYear()
Devuelve esteCalendarrepresentadoCalendar。 El año semanal está sincronizado con el ciclo semanal. first day of the first weekes el primer día de la semana.La implementación predeterminada de este método lanza
UnsupportedOperationException。- Resultado
- Este
Calendarde esteCalendar - Excepciones
-
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()
-
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.y
setel método es diferente; todos los campos del calendario ytimelos valores se calculan cuando se devuelven.Si
weekOfYearfuera 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 lanza
UnsupportedOperationException。- 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 lanza
UnsupportedOperationException。- 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 devolver
getMinimum()。- Parámetros
-
campo- Campo de calendario - Resultado
- Este
Calendardel 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
- Este
Calendardel 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.
-
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。
-
-