- java.lang.Object
- java.util.Calendar
- Interfaces implémentées
Serializable,Cloneable,Comparable<Calendar>
- Sous-classes directes connues :
GregorianCalendar
public abstract class Calendar extends Object implements Serializable, Cloneable, Comparable<Calendar>
La classeCalendarest une classe abstraite qui fournit des méthodes de conversion entre un instant précis et un ensemble de champscalendar fieldstels queYEAR,MONTH,DAY_OF_MONTH,HOURetc., ainsi que pour manipuler les champs de ce calendrier, par exemple pour obtenir la date de la semaine suivante. Un instant peut être représenté par une valeur en millisecondes, qui correspond à un décalage par rapport à l'Epoch du 1er janvier 1970 à 00:00:00,000 heure du méridien de Greenwich (calendrier grégorien). Cette classe fournit également des champs et des méthodes supplémentaires pour implémenter un système de calendrier concret en dehors du paquet. Ces champs et méthodes sont définis comme suit.protected。Comme les autres classes sensibles aux paramètres régionaux,
CalendarFournit une méthode de classe.getInstance, utilisé pour obtenir l'objet générique de ce type.Calendar的getInstanceLa méthode renvoie une valeur.CalendarUn objet dont les champs de calendrier sont initialisés avec la date et l'heure actuelles :Calendar rightNow = Calendar.getInstance();CalendarUn objet peut générer toutes les valeurs de champs de calendrier nécessaires au formatage des dates et heures selon un style de langue et de calendrier spécifique (par exemple, japonais-grégorien, japonais-traditionnel).CalendarDéfinit la plage de valeurs renvoyées par certains champs de calendrier et leur signification. Par exemple, la valeur du premier mois du système calendaire est la même pour tous les calendriers.MONTH == JANUARYLes autres valeurs sont définies par les sous-classes concrètes, par exempleERAPour plus de détails, consultez la documentation de chaque champ et celle des sous-classes.Obtenir et définir les valeurs des champs du calendrier
Pour ce faire, appelez
setMéthode pour définir les valeurs des champs du calendrier.CalendarLes valeurs de champ définies ne sont pas interprétées avant le calcul de leur valeur temporelle (millisecondes depuis Epoch) ou de la valeur des champs du calendrier.get,getTimeInMillis,getTime,add和rollIl s'agit d'un tel calcul.Large
CalendarIl possède deux modes pour interpréter les champs de calendrier : le mode tolérant et le mode strict.CalendarEn mode souple, il accepte des valeurs de champs de calendrier plus larges que celles qu'il produit.CalendarLe recalcul renvoie le résultat.CalendarLorsque la valeur du champ calendrier est traitée,get()Tous les champs de calendrier sont normalisés. Par exemple, en mode tolérantGregorianCalendar解释MONTH == JANUARY,DAY_OF_MONTH == 32Par exemple le 1er février.Quand
CalendarEn mode non indulgent, une exception est levée si le calendrier contient des champs incohérents. Par exemple,GregorianCalendarGénérez toujours une valeur comprise entre 1 et la longueur du mois.DAY_OF_MONTHvaleur. Si une valeur de champ hors limites a été définie, le mode non indulgentGregorianCalendarLève une exception lors du calcul de ses valeurs de champs temporels ou de calendrier.First Week
CalendarDéfinit une semaine de travail de sept jours spécifique à la locale avec deux paramètres : le premier jour de la semaine et le nombre minimal de jours de la première semaine (de 1 à 7). Lors de la constructionCalendarDans ce cas, ces nombres proviennent des données de ressources de la locale ou de la locale elle-même. Si la locale spécifiée contient les extensions Unicode « fw » et/ou « rg », le premier jour de la semaine sera obtenu à partir de ces extensions. Si « fw » et « rg » sont spécifiés simultanément, la valeur de l'extension « fw » remplace la valeur implicite de l'extension « rg ». Elles peuvent aussi être spécifiées explicitement via des méthodes de définition de leur valeur. Définition ou obtentionWEEK_OF_MONTH或WEEK_OF_YEARlorsque le champ est traité,CalendarIl faut déterminer la première semaine du mois ou de l'année comme point de référence. La première semaine d'un mois ou d'une année est définie comme la période de sept jours la plus ancienne qui commencegetFirstDayOfWeek()au début et qui contient au moinsgetMinimalDaysInFirstWeek()jours de ce mois ou de cette année. Les numéros de semaine avant la première semaine sont numérotés ..., -1, 0. Les semaines 2, 3, ... suivent. Notez queget()la numérotation normalisée retournée peut différer. Par exemple, uneCalendarsous-classe spécifique peut désigner la semaine précédant la semaine 1 de l'année comme la semainen周。Résolution des champs de calendrier
Lors du calcul d'une date et d'une heure à partir des champs du calendrier, les informations peuvent être insuffisantes. Par exemple, l'année et le mois sont présents, mais pas le jour. Les informations peuvent aussi être incohérentes. Par exemple, le 15 juillet 1996 est indiqué comme un mardi du calendrier grégorien. Or, cette date correspond en réalité à un lundi.CalendarLes valeurs des champs de calendrier sont résolues pour déterminer la date et l'heure de la manière suivante. S'il existe un conflit entre les valeurs des champs de calendrier,
Pour les champs d'heure de la journée :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 la valeur d'un champ de calendrier n'est pas définie dans la combinaison de champs sélectionnée,
Calendarsa valeur par défaut est utilisée. La valeur par défaut de chaque champ peut varier selon le système de calendrier concret. Par exemple, dansGregorianCalendarle système, la valeur par défaut d'un champ correspond au début de l'ère : c'est-à-direYEAR = 1970,MONTH = JANUARY,DAY_OF_MONTH = 1, etc.Remarque : il existe certaines ambiguïtés possibles dans l'interprétation de certaines heures singulières, résolues de la manière suivante :
- 23:59 est la dernière minute de la journée et 00:00 est la première minute du jour suivant. Donc, 31 décembre 1999 23:59 < 1er janvier 2000 00:00 < 1er janvier 2000 00:01.
- Bien que cela soit historiquement inexact, minuit appartient à « AM » et midi appartient à « PM ». Donc, le même jour, 12:00 AM (minuit) < 12:01 AM et 12:00 PM (midi) < 12:01 PM.
Les chaînes de format de date ou d'heure ne font pas partie de la définition du calendrier, car l'utilisateur doit pouvoir les modifier ou les remplacer à l'exécution. Utilisez
DateFormatpour formater les dates.Manipulation des champs
: les champs de calendrier peuvent être modifiés par trois méthodesset(),add()和roll().set(f, value)Modifie le champ de calendrierf至value. De plus, il définit une variable membre interne pour indiquer que le champ de calendrierfa été modifié. Bien que le champ de calendrierfsoit modifié immédiatement, la valeur de temps du calendrier en millisecondes n'est pas recalculée jusqu'au prochain appel deget(),getTime(),getTimeInMillis(),add(),或roll(). Ainsi, plusieurs appels àset()ne déclenchent pas plusieurs calculs inutiles. À la suite de l'utilisation deset()pour modifier un champ de calendrier, d'autres champs de calendrier peuvent également changer, selon le champ de calendrier, sa valeur et le système de calendrier. De plus,get(f)ne retourne pas nécessairementvaluepar le réglage téléphonique jusqu'àsetaprès que les champs du calendrier de la méthode ont été recalculés. Le comportement exact dépend de la classe de calendrier concrète.Par exemple : considérez
GregorianCalendarinitialement réglé au 31 août 1999 par l'appel,set(Calendar.MONTH, Calendar.SEPTEMBER)le jour est réglé au 31 septembre 1999, ce qui est une représentation interne temporaire qui se résout au 1er octobre 1999, sigetTime()puis l'appel. Cependant, lors de l'appelset(Calendar.DAY_OF_MONTH, 30)avant l'appelgetTime()la date est réglée au 30 septembre 1999, parce queset()n'a pas été recalculé après.add(f, delta)增加delta到现场f. Cela équivaut à deux ajustements par appelset(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 fieldfUn débordement se produit lorsque la valeur d'un champ dépasse sa plage. Le champ supérieur suivant est alors incrémenté ou décrémenté. La valeur du champ est ramenée dans sa plage.Ajoutez la règle 2. Un champ plus petit doit rester invariant. Mais il ne peut pas être égal à sa valeur précédente. Cela arrive si son minimum ou son maximum change après la modification du champ.
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.De plus, contrairement à
set(),add()force le recalcul immédiat des millisecondes du calendrier et de tous les champs.Par exemple : considérez
GregorianCalendarinitialement réglé au 31 août 1999 par l'appel,add(Calendar.MONTH, 13)le calendrier est réglé au 30 septembre 2000. La règle d'ajout 1 fixeMONTHle champ à septembre, car l'ajout de 13 mois donne septembre de l'année suivante. CommeDAY_OF_MONTHne peut pas être au 30 dans le mois de septembreGregorianCalendar, la règle d'ajout 2 fixe doncDAY_OF_MONTHà la valeur possible la plus proche. Bien que ce soit un champ plus petit,DAY_OF_WEEKla règle 2 n'apporte aucun ajustement àDAY_OF_WEEK, parce qu'un changement est prévu lorsque le mois change enGregorianCalendar.roll(f, delta)增加delta到现场fne modifie pas les champs plus grands. Cela équivaut à l'appel suivant par ajustementadd(f, delta):Règle de report (roll rule). Les champs plus grands restent inchangés après l'appel. Un champ plus grand représente une unité de temps plus grande.
DAY_OF_MONTHest un champ plus grand queHOUR.Exemple : consultez
GregorianCalendar.roll(int, int).Mode d'utilisation. Pour illustrer le comportement de
add()和roll(), considérez un composant d'interface avec des boutons d'incrémentation et de décrémentation pour le mois, le jour et l'année, ainsi qu'unGregorianCalendarsous-jacent. Si l'interface lit le 31 janvier 1999 et que l'utilisateur appuie sur le bouton d'incrémentation du mois, que doit-elle lire ? Si l'implémentation sous-jacente utiliseset(), elle lira peut-être le 3 mars 1999. Un meilleur résultat serait le 28 février 1999. De plus, si l'utilisateur appuie à nouveau sur le bouton d'incrémentation du mois, elle devrait lire le 31 mars 1999, et non le 28 mars 1999. En sauvegardant la date d'origine et en utilisantadd()或roll(), selon que le champ plus grand doit être affecté ou non, l'interface fonctionne comme la plupart des utilisateurs s'y attendent intuitivement.- Disponible depuis : 1.1 Voir aussi :
System.currentTimeMillis(),Date,GregorianCalendar,TimeZone,DateFormat, Serialized Form
-
-
嵌套类汇总
Classe imbriquée Variables et type Classe Description static classCalendar.BuilderCalendar.BuilderUtilisée pour créer unCalendar。
-
字段汇总
Champ Variables et type Description du champ static intALL_STYLESgetDisplayNamesSpécificateur de style pourstatic intAMAM_PMValeur du champ indiquant la période de la journée allant de minuit à juste avant midi.static intAM_PMget和setLes numéros de champ indiquent siHOURse situe avant ou après midi.static intAPRILMONTHValeur du champ indiquant le quatrième mois de l'année dans les calendriers grégorien et julien.protected booleanareFieldsSetSifields[]est synchronisé avec l'heure actuellement définie,fields[]True.static intAUGUSTMONTHValeur du champ indiquant le huitième mois de l'année dans les calendriers grégorien et julien.static intDATEget和setNuméros de champ indiquant le jour du mois.static intDAY_OF_MONTHget和setNuméros de champ indiquant le jour du mois.static intDAY_OF_WEEKNuméro de champ pourget和setIndique le jour de la semaine.static intDAY_OF_WEEK_IN_MONTHget和setNuméro de champ qui indique le rang du jour dans le mois en cours.static intDAY_OF_YEARget和setNuméro de champ qui indique le rang du jour dans l'année en cours.static intDECEMBERMONTHValeur du champ, qui indique le douzième mois de l'année dans les calendriers grégorien et julien.static intDST_OFFSETget和setNuméro de champ qui indique le décalage de l'heure d'été (en millisecondes).static intERAget和setNuméro de champ qui indique l'ère, par exemple AD ou BC dans le calendrier julien.static intFEBRUARYMONTHValeur du champ, qui indique le deuxième mois de l'année dans les calendriers grégorien et julien.static intFIELD_COUNTget和setNombre de champs distincts reconnus.protected int[]字段Valeurs des champs de calendrier à l'heure actuellement définie pour ce calendrier.static intFRIDAYDAY_OF_WEEKValeur du champ qui indique vendredi.static intHOURget和setNuméro de champ qui indique l'heure du matin ou de l'après-midi.static intHOUR_OF_DAYget和setNuméro de champ qui indique l'heure du jour.protected boolean[]isSetIndicateur qui signale si un champ de calendrier donné du calendrier est défini.protected booleanisTimeSetSi alorstimela valeur detimeest valide.static intJANUARYMONTHValeur du champ, qui indique le premier mois de l'année dans les calendriers Gregorian et Julian.static intJULYMONTHValeur du champ, qui indique le septième mois de l'année dans les calendriers grégorien et julien.static intJUNEMONTHValeur du champ, qui indique le sixième mois de l'année dans les calendriers grégorien et julien.static intLONGstatic intLONG_FORMATstatic intLONG_STANDALONEstatic intMARCHMONTHValeur du champ, qui indique le troisième mois de l'année dans les calendriers grégorien et julien.static intMAYMONTHValeur du champ, qui indique le cinquième mois de l'année dans les calendriers Gregorian et Julian.static intMILLISECONDget和setNuméro de champ qui indique les millisecondes de la seconde.static intMINUTEget和setNuméro de champ qui indique les minutes de l'heure.static intMONDAYDAY_OF_WEEKValeur du champ qui indique lundi.static intMONTHget和setles numéros de champ représentent le mois.static intNARROW_FORMATstatic intNARROW_STANDALONEstatic intNOVEMBERMONTHvaleur du champ, qui représente le onzième mois de l'année dans les calendriers grégorien et julien.static intOCTOBERMONTHvaleur du champ, qui représente le dixième mois de l'année dans les calendriers grégorien et julien.static intPMAM_PMvaleur du champ, qui représente la période de la journée allant de midi à minuit.static intSATURDAYvaleur du champDAY_OF_WEEK字段的值。static intSECONDget和setles numéros de champ représentent la seconde dans la minute.static intSEPTEMBERMONTHvaleur du champ, qui représente le neuvième mois de l'année dans les calendriers grégorien et julien.static intSHORTstatic intSHORT_FORMATstatic intSHORT_STANDALONEstatic intSUNDAYvaleur du champDAY_OF_WEEK字段的值。static intTHURSDAYDAY_OF_WEEKLa valeur du champ représente le jeudi.protected longtimeLe temps défini actuellement pour ce calendrier, exprimé en millisecondes après le 1er janvier 1970 à 0:00:00 GMT.static intTUESDAYvaleur du champDAY_OF_WEEK字段的值。static intUNDECIMBERMONTHvaleur du champ, qui représente le treizième mois de l'année.static intWEDNESDAYDAY_OF_WEEKLa valeur du champ représente le mercredi.static intWEEK_OF_MONTHget和setles numéros de champ,getset的周数。static intWEEK_OF_YEARget和setles numéros de champ représentent le numéro de semaine dans l'année en cours.static intYEARLe numéro de champ estget和setreprésente l'année.static intZONE_OFFSETget和setles numéros de champ, qui représentent le décalage brut par rapport à GMT en millisecondes.
-
方法摘要
所有方法 静态方法 实例方法 抽象方法 具体的方法 变量和类型 方法 Description abstract voidadd(int field, int amount)Ajoute ou soustrait la durée spécifiée au champ de calendrier donné, selon les règles du calendrier.booleanafter(Object when)Retourne si ceCalendar是否表示指定的Objectreprésenté par l'objet spécifié.booleanbefore(Object when)Retourne si ceCalendar是否表示指定的Objectreprésenté par l'objet spécifié.voidclear()voidclear(int field)Objectclone()Crée et retourne une copie de cet objet.intcompareTo(Calendar anotherCalendar)protected voidcomplete()Remplit tous les champs non définis dans les champs de calendrier.protected abstract voidcomputeFields()protected abstract voidcomputeTime()Convertit les valeurs actuelles des champs de calendrierfields[]en valeur temporelle en millisecondestime。booleanequals(Object obj)Compare ceCalendaravec l'objetObject。intget(int field)Retourne la valeur du champ de calendrier donné.intgetActualMaximum(int field)Étant donnée la valeur temporelle de ceCalendar, retourne laCalendar。intgetActualMinimum(int field)Étant donnée la valeur temporelle de ceCalendar, retourne laCalendar。static Set<String>getAvailableCalendarTypes()Retourne unSetnon modifiable contenant tous les types de calendrierCalendarsupportés par l'environnement d'exécution.static Locale[]getAvailableLocales()Retourne le tableau de tous les paramètres régionaux,getInstancela méthodegetInstanceretourne une instance localisée.StringgetCalendarType()Retourne le type de calendrierCalendarde cette instance.StringgetDisplayName(int field, int style, Locale locale)Retourne la représentation sous forme de chaînestyle和locale日历字段donnéslocale。Map<String,Integer>getDisplayNames(int field, int style, Locale locale)Retourne unMapcontenant tous les noms dustyle和locale日历字段所有名称及其对应的字段值。intgetFirstDayOfWeek()Retourne le premier jour de la semaine. Par exemple,SUNDAY在美国,MONDAY在法国。abstract intgetGreatestMinimum(int field)Retourne la plus grande valeur minimale du champ de calendrier donnéCalendarde cette instance.static CalendargetInstance()Retourne un calendrier avec le fuseau horaire et les paramètres régionaux par défaut.static CalendargetInstance(Locale aLocale)Retourne un calendrier avec le fuseau horaire par défaut et les paramètres régionaux spécifiés.static CalendargetInstance(TimeZone zone)Retourne un calendrier avec le fuseau horaire spécifié et les paramètres régionaux par défaut.static CalendargetInstance(TimeZone zone, Locale aLocale)Retourne un calendrier avec le fuseau horaire et les paramètres régionaux spécifiés.abstract intgetLeastMaximum(int field)Retourne la plus petite valeur maximale du champ de calendrier donnéCalendarde cette instance.abstract intgetMaximum(int field)Retourne leCalendar实例的给定日历字段的Calendar。intgetMinimalDaysInFirstWeek()Retourne le nombre minimal de jours de la première semaine de l'année. Par exemple, si la première semaine est définie comme celle contenant le premier jour du premier mois de l'année, la méthode retourne 1.abstract intgetMinimum(int field)Retourne leCalendar实例的给定日历字段的Calendar。DategetTime()longgetTimeInMillis()Retourne la valeur temporelle de ce Calendar en millisecondes.TimeZonegetTimeZone()Retourne le fuseau horaire.intgetWeeksInWeekYear()Retourne la semaine de l'annéeCalendarreprésentée par ceCalendar。intgetWeekYear()Retourne laCalendarreprésentée parCalendar。inthashCode()Retourne le code de hachage de ce calendrier.protected intinternalGet(int field)Retourne la valeur du champ de calendrier donné.booleanisLenient()Indique si l'interprétation de la date et de l'heure est souple.booleanisSet(int field)Détermine si le champ de calendrier donné a une valeur définie, y compris le cas des valeurs définies par les calculs internes déclenchés par un appel à la méthodeget.booleanisWeekDateSupported()Indique si ceCalendarprend en charge les dates hebdomadaires.abstract voidroll(int field, boolean up)Ajoute ou soustrait (vers le haut ou vers le bas) une seule unité de temps sur le champ temporel donné sans modifier les champs plus grands.voidroll(int field, int amount)Ajoute le montant spécifié (signé) au champ de calendrier donné sans modifier les champs plus grands.voidset(int field, int value)Définit le champ de calendrier donné à la valeur donnée.voidset(int year, int month, int date)Définit les valeurs des champs de calendrierYEAR,MONTH和DAY_OF_MONTH。voidset(int year, int month, int date, int hourOfDay, int minute)Définit les valeurs des champs de calendrierYEAR,MONTH,DAY_OF_MONTH,HOUR_OF_DAY和MINUTE。voidset(int year, int month, int date, int hourOfDay, int minute, int second)Définit les valeurs des champsYEAR,MONTH,DAY_OF_MONTH,HOUR_OF_DAY,MINUTE和SECOND。voidsetFirstDayOfWeek(int value)Définit le premier jour de la semaine. Par exemple,SUNDAY在美国,MONDAY在法国。voidsetLenient(boolean lenient)Indique si l'interprétation de la date et de l'heure est souple.voidsetMinimalDaysInFirstWeek(int value)Définit le nombre minimal de jours requis pour la première semaine de l'année. Par exemple, si la première semaine est définie comme celle contenant le premier jour du premier mois de l'année, appelez cette méthode avec la valeur 1.voidsetTime(Date date)Définit l'heure de ce calendrier avec leDatedonné.voidsetTimeInMillis(long millis)Définit l'heure actuelle de ce Calendar à partir de la valeur long donnée.voidsetTimeZone(TimeZone value)Définit le fuseau horaire avec la valeur de fuseau horaire donnée.voidsetWeekDate(int weekYear, int weekOfYear, int dayOfWeek)Utilise le spécificateur de date donné pour définir la date de ceCalendarcalendrier : année de l'ère, semaine de l'année et jour de la semaine.InstanttoInstant()Convertit cet objet enInstant.StringtoString()Retourne la représentation sous forme de chaîne de ce calendrier.
-
-
-
字段详细信息
-
ERA
public static final int ERA
get和setNuméro de champ pour l'ère, par exemple AD ou BC dans le calendrier julien. C'est une valeur spécifique au calendrier. Consultez la documentation des sous-classes.- Voir aussi :
GregorianCalendar.AD,GregorianCalendar.BC, Valeur de champ constante
-
YEAR
public static final int YEAR
get和setNuméro de champ pour l'année. C'est une valeur spécifique au calendrier. Consultez la documentation des sous-classes.
-
MONTH
public static final int MONTH
get和setNuméro de champ pour le mois. C'est une valeur spécifique au calendrier. Dans les calendriers grégorien et julien, le premier mois estJANUARY, soit 0. Le dernier dépend du nombre de mois dans l'année.
-
WEEK_OF_YEAR
public static final int WEEK_OF_YEAR
get和setNuméro de champ pour le numéro de semaine de l'année en cours. La première semaine de l'année, définie pargetFirstDayOfWeek()和getMinimalDaysInFirstWeek(), a la valeur 1. Les sous-classes définissent le nombre de jours avant la première semaine de l'année.WEEK_OF_YEAR的值。- Voir aussi :
getFirstDayOfWeek(),getMinimalDaysInFirstWeek(), valeurs des champs de constantes
-
WEEK_OF_MONTH
public static final int WEEK_OF_MONTH
get和set字段编号表示getle numéro de la semaine. La première semaine du mois, définie pargetFirstDayOfWeek()和getMinimalDaysInFirstWeek(), a la valeur 1. Les sous-classes définissent la valeur des jours précédant la première semaine du mois.WEEK_OF_MONTH。- Voir aussi :
getFirstDayOfWeek(),getMinimalDaysInFirstWeek(), valeurs de champ constantes
-
DATE
public static final int DATE
get和setLe numéro de champ indique le jour du mois. C'est unDAY_OF_MONTHsynonyme de . Le premier jour du mois a la valeur 1.- Voir aussi :
DAY_OF_MONTH, valeurs de champ constantes
-
DAY_OF_MONTH
public static final int DAY_OF_MONTH
get和setLe numéro du champ indique la date du mois en cours. C'estDATELa valeur du premier jour du mois est 1.- Voir aussi :
DATE, valeur de champ constante
-
DAY_OF_YEAR
public static final int DAY_OF_YEAR
get和setLe numéro du champ indique le numéro du jour dans l'année. Le premier jour de l'année vaut 1.
-
DAY_OF_WEEK
public static final int DAY_OF_WEEK
get和setLe champ numéro indique le jour de la semaine. La valeur de ce champSUNDAY,MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY和SATURDAY。
-
DAY_OF_WEEK_IN_MONTH
public static final int DAY_OF_WEEK_IN_MONTH
get和setNuméro de champ indiquant le rang du jour de la semaine dans le mois. Avec le champDAY_OF_WEEK, cela identifie de manière unique un jour du mois. Contrairement àWEEK_OF_MONTH和WEEK_OF_YEAR, la valeur de ce champ ne dépend pas degetFirstDayOfWeek()或getMinimalDaysInFirstWeek().DAY_OF_MONTH 1至7auDAY_OF_WEEK_IN_MONTH 1correspond à8到14duDAY_OF_WEEK_IN_MONTH 2auDAY_OF_WEEK_IN_MONTH 0表示DAY_OF_WEEK_IN_MONTH 1indiqueDAY_OF_WEEK = SUNDAY, DAY_OF_WEEK_IN_MONTH = -1la semaine précédente. Les valeurs négatives se comptent à partir de la fin du mois, donc le dernier dimanche du mois vautDAY_OF_WEEK_IN_MONTH -1. Comme les valeurs négatives se comptent à rebours, leur alignement dans le mois diffère généralement de celui des valeurs positives. Par exemple, si un mois compte 31 jours,DAY_OF_WEEK_IN_MONTH 5和4et- fin.
DAY_OF_WEEKVoir aussi :WEEK_OF_MONTH,
-
AM_PM
public static final int AM_PM
get和set字段编号表示HOURNuméro de champ indiquant siAM_PM是PM。
-
HOUR
public static final int HOUR
get和setle numéro de champ indique l'heure du matin ou de l'après-midi.HOURUtilisé pour le format 12 heures (0 - 11). Midi et minuit sont représentés par 0, et non par 12. Par exemple, à 10:04:15.250 PM,HOURvaut 10.- Voir aussi :
AM_PM,HOUR_OF_DAY, valeur de champ constante
-
HOUR_OF_DAY
public static final int HOUR_OF_DAY
get和setle numéro de champ indique l'heure du jour.HOUR_OF_DAYUtilisé pour le format 24 heures. Par exemple, à 10:04:HOUR_OF_DAYPM, il vaut 22.- Voir aussi :
HOUR, valeur de champ constante
-
MINUTE
public static final int MINUTE
get和setle numéro de champ indique la minute dans l'heure. Par exemple, à 10:04:MINUTEPM, il vaut 4.
-
SECOND
public static final int SECOND
get和setle numéro de champ indique la seconde dans la minute. Par exemple, à 10:04:SECONDPM, il vaut 15.
-
MILLISECOND
public static final int MILLISECOND
get和setle numéro de champ indique les millisecondes dans la seconde. Par exemple, à 10:04:MILLISECONDPM, il vaut 250.
-
ZONE_OFFSET
public static final int ZONE_OFFSET
get和setle numéro de champ indique le décalage brut par rapport à GMT (en millisecondes). SiTimeZonela sous-classe d'implémentation prend en charge les changements historiques de décalage GMT, ce champ reflète laCalendarvaleur correcte du décalage GMT du fuseau horaire de
-
DST_OFFSET
public static final int DST_OFFSET
get和setetTimeZoneSi la sous-classe gère les changements historiques d'heure d'été, ce champ reflète ceCalendardécalage d'heure d'été correct du fuseau horaire.
-
FIELD_COUNT
public static final int FIELD_COUNT
get和setNombre de champs distincts reconnus. Les numéros de champs vont de0..FIELD_COUNT-1。
-
SUNDAY
public static final int SUNDAY
Valeur du champDAY_OF_WEEK字段的值。
-
MONDAY
public static final int MONDAY
DAY_OF_WEEKValeur du champ représentant le lundi.
-
TUESDAY
public static final int TUESDAY
Valeur du champDAY_OF_WEEK字段的值。
-
WEDNESDAY
public static final int WEDNESDAY
DAY_OF_WEEKValeur du champ représentant le mercredi.
-
THURSDAY
public static final int THURSDAY
DAY_OF_WEEKValeur du champ représentant le jeudi.
-
FRIDAY
public static final int FRIDAY
Valeur du champDAY_OF_WEEK字段的值。
-
SATURDAY
public static final int SATURDAY
Valeur du champDAY_OF_WEEK字段的值。
-
JANUARY
public static final int JANUARY
MONTHValeur du champ représentant le premier mois de l'année dans les calendriers grégorien et julien.
-
FEBRUARY
public static final int FEBRUARY
MONTHValeur du champ représentant le deuxième mois de l'année dans les calendriers grégorien et julien.
-
MARCH
public static final int MARCH
MONTHValeur du champ qui représente le troisième mois de l'année dans les calendriers grégorien et julien.
-
APRIL
public static final int APRIL
MONTHValeur du champ qui représente le quatrième mois de l'année dans les calendriers grégorien et julien.
-
MAY
public static final int MAY
MONTHValeur du champ qui représente le cinquième mois de l'année dans les calendriers grégorien et julien.
-
JUNE
public static final int JUNE
MONTHValeur du champ qui représente le sixième mois de l'année dans les calendriers grégorien et julien.
-
JULY
public static final int JULY
MONTHValeur du champ qui représente le septième mois de l'année dans les calendriers grégorien et julien.
-
AUGUST
public static final int AUGUST
MONTHValeur du champ qui représente le huitième mois de l'année dans les calendriers grégorien et julien.
-
SEPTEMBER
public static final int SEPTEMBER
MONTHValeur du champ qui représente le neuvième mois de l'année dans les calendriers grégorien et julien.
-
OCTOBER
public static final int OCTOBER
MONTHValeur du champ qui représente le dixième mois de l'année dans les calendriers grégorien et julien.
-
NOVEMBER
public static final int NOVEMBER
MONTHValeur du champ qui représente le onzième mois de l'année dans les calendriers grégorien et julien.
-
DECEMBER
public static final int DECEMBER
MONTHValeur du champ qui représente le douzième mois de l'année dans les calendriers grégorien et julien.
-
UNDECIMBER
public static final int UNDECIMBER
MONTHValeur du champ qui représente le treizième mois de l'année. Bien queGregorianCalendarcette valeur ne soit pas utilisée, les calendriers lunaires l'utilisent.
-
AM
public static final int AM
AM_PMValeur du champ qui représente la période de la journée de minuit à juste avant midi.
-
PM
public static final int PM
AM_PMValeur du champ qui représente la période de la journée de midi à juste avant minuit.
-
ALL_STYLES
public static final int ALL_STYLES
getDisplayNamesle spécificateur de style, qui indique les noms de tous les styles, par exemple « January » et « Jan ».- Disponible depuis : 1.6 Voir aussi :
SHORT_FORMAT,LONG_FORMAT,SHORT_STANDALONE,LONG_STANDALONE,SHORT,LONG, Valeurs des constantes de champ
-
SHORT
public static final int SHORT
- Disponible depuis : 1.6 Voir aussi :
SHORT_STANDALONE,LONG, Valeurs des constantes de champ
-
LONG
public static final int LONG
- Disponible depuis : 1.6 Voir aussi :
LONG_STANDALONE,SHORT, Valeurs des constantes de champ
-
NARROW_FORMAT
public static final int NARROW_FORMAT
getDisplayNameetgetDisplayNamesest un spécificateur de style pour, qui indique le nom étroit utilisé pour le format. Le nom étroit est généralement une seule chaîne, par exemple « M » pour lundi.- Disponible depuis : 1.8 Voir aussi :
NARROW_STANDALONE,SHORT_FORMAT,LONG_FORMAT, Valeurs des constantes de champ
-
NARROW_STANDALONE
public static final int NARROW_STANDALONE
getDisplayNameetgetDisplayNamesest un spécificateur de style pour, qui indique le nom étroit en mode autonome. Le nom étroit est généralement une seule chaîne, par exemple « M » pour lundi.- Disponible depuis : 1.8 Voir aussi :
NARROW_FORMAT,SHORT_STANDALONE,LONG_STANDALONE, Valeurs des constantes de champ
-
SHORT_FORMAT
public static final int SHORT_FORMAT
getDisplayNameetgetDisplayNamesest un spécificateur de style pour, qui indique le nom court utilisé pour le format.- Disponible depuis : 1.8 Voir aussi :
SHORT_STANDALONE,LONG_FORMAT,LONG_STANDALONE, valeur de champ constante
-
LONG_FORMAT
public static final int LONG_FORMAT
getDisplayNameetgetDisplayNamesSpécificateur de format qui indique le nom long utilisé pour le formatage.- Disponible depuis la version : 1.8. Voir aussi :
LONG_STANDALONE,SHORT_FORMATIl n'y a pas de texte à traduire.SHORT_STANDALONE, valeur de champ constante
-
SHORT_STANDALONE
public static final int SHORT_STANDALONE
getDisplayNameetgetDisplayNamesdu symbole de spécification de style, qui indique un nom court utilisé de manière autonome, par exemple l'abréviation du mois comme titre de calendrier.- Disponible depuis la version : 1.8. Voir aussi :
SHORT_FORMAT,LONG_FORMAT,LONG_STANDALONE, valeur du champ constant
-
LONG_STANDALONE
public static final int LONG_STANDALONE
getDisplayNameetgetDisplayNamesLe spécificateur de style ` ` indique un nom long utilisé seul, par exemple le nom du mois comme titre de calendrier.- Disponible à partir de la version : 1.8 Voir aussi :
LONG_FORMAT,SHORT_FORMAT,SHORT_STANDALONE, Valeurs des champs constants
-
字段
protected int[] fields
Valeurs des champs de calendrier pour l'heure actuellement définie de ce calendrier. C'est unFIELD_COUNTtableau d'entiers dont les indices vontERA到DST_OFFSET。
-
isSet
protected boolean[] isSet
Indicateurs signalant si les champs de calendrier spécifiés du calendrier sont définis. Un nouvel objet n'a aucun champ défini. Après le premier appel d'une méthode générant les champs, ils restent définis ensuite. C'est un ensemble deFIELD_COUNTBooléen, la valeur d'index estERA到DST_OFFSET。
-
time
protected long time
Heure actuellement définie pour ce calendrier, exprimée en millisecondes écoulées depuis le 1er janvier 1970 à 0:00:00, heure du méridien de Greenwich.- Voir aussi :
isTimeSet
-
isTimeSet
protected boolean isTimeSet
si... alorstimeLa valeur est valide.timeVrai. En modifiant les champsfield[]l'heure devient invalide.- Voir aussi :
time
-
areFieldsSet
protected boolean areFieldsSet
estfields[]synchronisé avec l'heure actuellement définie,fields[]Vrai. Si la valeur est false, la prochaine tentative de lecture d'un champ force le recalcul de la valeur actuelletimede tous les champs.
-
-
构造方法详细信息
-
Calendar
protected Calendar()
Construit un calendrier avec le fuseau horaire par défaut et lesFORMATparamètres régionaux par défaut.- Voir aussi :
TimeZone.getDefault()
-
-
方法详细信息
-
getInstance
public static Calendar getInstance()
Obtient un calendrier avec le fuseau horaire et les paramètres régionaux par défaut. L'objet retournéCalendarest basé sur l'heure actuelle dans le fuseau horaire par défaut, avec lesFORMATparamètres régionaux par défaut. Si les paramètres régionaux contiennent le fuseau horaire « tz » Unicode extension, ce fuseau horaire est utilisé.- Résultat : un calendrier.
-
getInstance
public static Calendar getInstance(TimeZone zone)
Obtient un calendrier avec le fuseau horaire spécifié et les paramètres régionaux par défaut. L'objet retournéCalendarest basé sur l'heure actuelle dans le fuseau horaire donné, avec lesFORMATparamètres régionaux par défaut.- Paramètres
zone- le fuseau horaire à utiliser. Résultat : un calendrier.
-
getInstance
public static Calendar getInstance(Locale aLocale)
Obtient un calendrier avec le fuseau horaire par défaut et les paramètres régionaux spécifiés. L'objet retournéCalendarest basé sur l'heure actuelle dans le fuseau horaire par défaut, avec les paramètres régionaux donnés. Si les paramètres régionaux contiennent le fuseau horaire « tz » Unicode extension, ce fuseau horaire est utilisé.- Paramètres
aLocale- les paramètres régionaux pour les données de semaine. Résultat : un calendrier.
-
getInstance
public static Calendar getInstance(TimeZone zone, Locale aLocale)
Obtient un calendrier avec le fuseau horaire et les paramètres régionaux spécifiés. L'objet retournéCalendarest basé sur l'heure actuelle dans le fuseau horaire donné, avec les paramètres régionaux donnés.- Paramètres
zone- le fuseau horaire à utiliseraLocale- Paramètres régionaux des données hebdomadaires. Résultat : calendrier.
-
getAvailableLocales
public static Locale[] getAvailableLocales()
RetournegetInstanceLa méthode peut retourner un tableau de tous les paramètres régionaux des instances localisées. Le tableau retourné doit contenir au moins une instance égale àLocale.US的LocaleParamètres régionaux pour lesquels des instances localisées sont disponibles.- Résultat : un ensemble de paramètres régionaux pour lesquels des instances localisées
Calendarsont disponibles.
-
computeTime
protected abstract void computeTime()
Convertit les valeurs actuelles des champs de calendrier dansfields[]en valeur de temps en millisecondestime。- Voir aussi :
complete(),computeFields()
-
computeFields
protected abstract void computeFields()
Convertit la valeur de temps actuelle en millisecondes en valeurs des champs de calendrier detime的日历字段值fields[].complete()Voir aussi :- getTime
computeTime()
-
getTime
public final Date getTime()
représentant la valeur de temps de ceCalendar(décalage en millisecondes par rapport à l'Epoch).Date对象。- : la valeur de temps représentée. Voir aussi :
Date,setTime(Date)setTimegetTimeInMillis()
-
setTime
public final void setTime(Date date)
donné. Remarque : appelerDateavecDate(Long.MAX_VALUE)或Date(Long.MIN_VALUE)调用setTime().get()Paramètres- - la date donnée. Voir aussi :
date,getTime()getTimeInMillissetTimeInMillis(long)
-
getTimeInMillis
public long getTimeInMillis()
Résultat : l'heure actuelle depuis l'époque en millisecondes UTC. Voir aussi :- 结果
- 从纪元开始的当前时间为UTC毫秒。
- 另请参见:
-
getTime(),setTimeInMillis(long)
-
setTimeInMillis
public void setTimeInMillis(long millis)
Définit l'heure actuelle de ce Calendar à partir de la valeur long donnée.- Paramètres
millis- la nouvelle heure en millisecondes UTC depuis l'époque. Voir aussi :setTime(Date),getTimeInMillis()
-
get
public int get(int field)
Retourne la valeur du champ de calendrier donné. En mode indulgent, tous les champs de calendrier sont normalisés. En mode strict, tous les champs de calendrier sont validés. Si un champ dépasse la plage autorisée, cette méthode lève une exception. La normalisation et la validation sont gérées par la méthodecomplete(),qui dépend du système de calendrier.- Paramètres
字段- le champ de calendrier donné. Résultat : la valeur du champ de calendrier donné. ExceptionsArrayIndexOutOfBoundsException- si le champ spécifié est hors plage (field < 0 || field >= FIELD_COUNT). Voir aussi :set(int,int),complete()
-
internalGet
protected final int internalGet(int field)
Retourne la valeur du champ de calendrier donné. Cette méthode n'effectue aucune normalisation ni validation de la valeur du champ.- Paramètres
字段- le champ de calendrier donné. Résultat : la valeur du champ de calendrier donné. Voir aussi :get(int)
-
set
public void set(int field, int value)Définit le champ de calendrier donné à la valeur donnée. Quel que soit le mode, cette méthode n'interprète pas la valeur.- Paramètres
字段- le champ de calendrier donné.value- la valeur à définir pour le champ de calendrier donné. ExceptionsArrayIndexOutOfBoundsException- si le champ spécifié est hors plage (field < 0 || field >= FIELD_COUNT). En mode strict. Voir aussi :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)Définit les valeurs des champs de calendrierYEAR,MONTH和DAY_OF_MONTH. Les valeurs précédentes des autres champs de calendrier sont conservées. Si ce n'est pas souhaité, appelez d'abordclear().- Paramètres
year- 用于设置YEAR.month- 用于设置MONTH. Les valeurs des mois commencent à 0. Par exemple, 0 correspond à janvier.date- 用于设置DAY_OF_MONTHValeur du champ du calendrier. Voir aussi :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)Définit la valeur du champ du calendrierYEAR,MONTH,DAY_OF_MONTH,HOUR_OF_DAY和MINUTE. Conserve les valeurs précédentes des autres champs. Si ce n'est pas souhaité, appelez d'abordclear().- Paramètres
year- 用于设置YEARla valeur du champ du calendrier.month- 用于设置MONTHla valeur du champ du calendrier. Les valeurs des mois commencent à 0. Par exemple, 0 représente janvier.date- 用于设置DAY_OF_MONTHla valeur du champ du calendrier.hourOfDay- 用于设置HOUR_OF_DAYla valeur du champ du calendrier.minute- 用于设置MINUTEla valeur du champ du calendrier. Voir aussi :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)Définit la valeur dans le champYEAR,MONTH,DAY_OF_MONTH,HOUR_OF_DAY,MINUTE和SECOND. Conserve les valeurs précédentes des autres champs. Si ce n'est pas souhaité, appelez d'abordclear().- Paramètres
year- 用于设置YEARla valeur du champ du calendrier.month- 用于设置MONTHla valeur du champ du calendrier. Les valeurs des mois commencent à 0. Par exemple, 0 représente janvier.date- 用于设置DAY_OF_MONTHla valeur du champ du calendrier.hourOfDay- 用于设置HOUR_OF_DAYdu champ de calendrier.minute- 用于设置MINUTEdu champ de calendrier.second- 用于设置SECONDdu champ de calendrier. Voir aussi :set(int,int),set(int,int,int),set(int,int,int,int,int)
-
clear
public final void clear()
Définit commeCalendarnon définies toutes les valeurs de champs de calendrier et de temps (décalage en millisecondes par rapport à Epoch). Cela signifie queisSet()renverrafalsepour tous les champs de calendrier, et que les calculs de date et d'heure traiteront les champs comme jamais définis.CalendarLa classe d'implémentation utilise ses valeurs de champs par défaut spécifiques pour les calculs de date et d'heure. Par exemple, si la valeur du champYEARest non définie, alorsGregorianCalendarutilise 1970.- Voir aussi :
clear(int)
-
clear
public final void clear(int field)
Définit commeCalendarnon définie la valeur du champ de calendrier donné et la valeur de temps (décalage en millisecondes par rapport à Epoch). Cela signifie queisSet(field)renverrafalse, et que les calculs de date et d'heure traiteront ce champ comme jamais défini.CalendarLa classe d'implémentation utilise les valeurs par défaut spécifiques du champ pour les calculs de date et d'heure. Les champsHOUR_OF_DAY,HOURetAM_PMsont traités indépendamment, et la règle de résolution pour l'heure du jour s'applique. Effacer l'un de ces champs ne réinitialise pas la valeur d'heure de ceCalendar. Utilisezset(Calendar.HOUR_OF_DAY, 0)pour réinitialiser la valeur d'heure.- Paramètres
字段- Le champ de calendrier à effacer. Voir aussi :clear()
-
isSet
public final boolean isSet(int field)
Détermine si le champ de calendrier donné possède une valeur définie, y compris celles définies parget.- Paramètres
字段- Le champ de calendrier à tester. Résultattruetrue si le champ de calendrier donné possède un ensemble de valeurs, sinonfalse.
-
getDisplayName
public String getDisplayName(int field, int style, Locale locale)
Retourne le nom dustyle和locale日历字段Représentation sous forme de chaîne de la valeurlocale. S'il n'existe aucune représentation sous forme de chaîne applicable, la méthode renvoienull. Si une représentation sous forme de chaîne s'applique au calendrier donné字段alors cette méthode appelleget(field)pour obtenir la valeur du calendrier字段. Par exemple, si ceCalendar是GregorianCalendaret que sa date est 2005-01-01, alorsMONTHla représentation sous forme de chaîne du champ sera « janvier » en style long ou « janv. » en style court dans la locale anglaise. Cependant,DAY_OF_MONTHsi le champ n'a pas de représentation sous forme de chaîne disponible, cette méthode renvoienull。L'implémentation par défaut prend en charge les champs de calendrier
DateFormatSymbolspour lesquels un nom est donnélocale。- Paramètres
字段- le champ de calendrier dont on veut la représentation sous forme de chaînestyle- le style appliqué à la représentation sous forme de chaîne ; l'une des valeursSHORT_FORMAT(SHORT),SHORT_STANDALONE,LONG_FORMAT(LONG),LONG_STANDALONE,NARROW_FORMAT, ouNARROW_STANDALONE.locale- la locale de la représentation sous forme de chaîne (tout type de calendrier spécifié parlocaleest ignoré) Résultat la représentation sous forme de chaîne du字段donné dans lestyle字符串表示style, oustyle,null. ExceptionsIllegalArgumentException- 如果字段或style无效,或者此Calendarn'est pas indulgent et qu'un champ de calendrier a une valeur invalideNullPointerException- 如果localeest nul Depuis la version : 1.6
-
getDisplayNames
public Map<String,Integer> getDisplayNames(int field, int style, Locale locale)
RetourneMapune structure contenant, pour le champ de calendrier donnéstyle和locale日历字段donnés, tous les noms et leurs valeurs de champ correspondantes. Par exemple, si ceCalendarestGregorianCalendar, la carte retournée contiendra « Jan » associé àJANUARY, « Feb » associé àFEBRUARY, et ainsi de suite, selon le style short de la locale anglaise. Comme les noms réduits utilisent un seul caractère, ils ne sont pas forcément uniques, par exemple « S » pour dimanche et samedi. Dans ce cas, les noms réduits ne sont pas inclus dans laMap。D'autres valeurs de champs de calendrier peuvent être prises en compte pour déterminer un ensemble de noms d'affichage. Par exemple, si ce
Calendarest un système de calendrier luni-solaire et que la valeur d'année donnée par le champYEARcomporte un mois intercalaire, cette méthode retourne les noms de mois incluant le mois intercalaire, et ces noms sont associés aux noms de mois spécifiques à cette année.L'implémentation par défaut prend en charge les noms d'affichage contenus dans
DateFormatSymbols. Par exemple, si字段estMONTHet questyleestALL_STYLES, cette méthode retourneMapcontenant toutes les chaînes retournées parDateFormatSymbols.getShortMonths()etDateFormatSymbols.getMonths().- Paramètres
字段- le champ de calendrier dont les noms d'affichage sont retournésstyle- le style appliqué à la représentation sous forme de chaîne ; l'une des valeursSHORT_FORMAT(SHORT),SHORT_STANDALONE,LONG_FORMAT(LONG),LONG_STANDALONE,NARROW_FORMAT, ouNARROW_STANDALONE-
locale- la locale des noms d'affichage. Résultat. Une Mapcontenant tous les noms d'affichagestyle和localeavec leurs valeurs de champ, ounullsi aucun nom d'affichage n'est défini pour字段- Exceptions
IllegalArgumentException- 如果字段或style无效,或者此Calendarn'est pas permissif et qu'un champ de calendrier a une valeur invalideNullPointerException- 如果localeest vide. Depuis la version : 1.6
-
complete
protected void complete()
Remplit tous les champs non définis du calendrier. D'abord, si la valeur temporelle (décalage en millisecondes depuis l'Epoch) n'a pas encore été calculée à partir des champs de calendrier, la méthodecomputeTime()est appelée. Ensuite, la méthodecomputeFields()est appelée pour calculer toutes les valeurs des champs de calendrier.
-
getAvailableCalendarTypes
public static Set<String> getAvailableCalendarTypes()
Retourne unSetnon modifiable contenant tous les types de calendrierCalendarpris en charge dans l'environnement d'exécution. Les types de calendrier disponibles servent aux extensions de locale Unicode. LeSetretourné contient au moins"gregory". Les types de calendrier n'incluent pas les alias, par exemple"gregorian"("gregory"。- Résultat : un
Set- non modifiable contenant tous les types de calendrier disponibles. Depuis la version : 1.8 Voir aussi :
getCalendarType(),Calendar.Builder.setCalendarType(String),Locale.getUnicodeLocaleType(String)
-
getCalendarType
public String getCalendarType()
Retourne le type de calendrier de ceCalendar. Le type de calendrier est défini par la spécification Unicode Locale Data Markup Language (LDML). L'implémentation par défaut de cette méthode retourne le nom de classe de cette instanceCalendar. Toute sous-classe implémentant un système de calendrier défini par LDML doit redéfinir cette méthode pour retourner le type de calendrier approprié.- Résultat : le type de calendrier défini par LDML, ou le nom de classe de cette instance
Calendar. Depuis la version : 1.8 Voir aussi : Locale extensions ,Locale.Builder.setLocale(Locale),Locale.Builder.setUnicodeLocaleKeyword(String, String)
-
equals
public boolean equals(Object obj)
Compare ceCalendaravec leObjectspécifié. Le résultat estCalendarsi et seulement si l'argument est untruedu même système de calendrier, représentant la même valeur temporelle (décalage en millisecondes depuis l'Epoch) sous les mêmesCalendarparamètres. LesCalendarparamètres sont les valeurs représentées parisLenient,getFirstDayOfWeek,getMinimalDaysInFirstWeek和getTimeZone. Si un paramètre diffère entre les deuxCalendar, cette méthode retournefalse。Utilisation
compareToLa méthode compare uniquement les valeurs temporelles.- Remplacement :
equals类Object- Paramètres
obj- l'objet à comparer. Résultattruetrue si cet objet est égal àobj; sinonfalse. Voir aussi :Object.hashCode(),HashMap
-
hashCode
public int hashCode()
Retourne le code de hachage de ce calendrier.- Remplacement :
hashCode, classeObject- Résultat la valeur du code de hachage de cet objet. Depuis : 1.2 Voir aussi :
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
before
public boolean before(Object when)
Retourne si ceCalendar是否表示指定的Objectspécifié. Cette méthode est équivalente à :当且仅当compareTo(when) < 0when是Calendar. Sinon, la méthode retournefalse。- Paramètres
when- 待比较的Object- à comparer
trueRésultatCalendartrue si le temps représenté par cewhenest antérieur au temps représenté parfalse; sinoncompareTo(Calendar)
-
after
public boolean after(Object when)
Retourne si ceCalendar是否表示指定的Objectspécifié. Cette méthode est équivalente à :当且仅当compareTo(when) > 0when是Calendar. Sinon, la méthode retournefalse。- Paramètres
when- 待比较的Object- Résultat
true如果此Calendar的时间when于when; sinon renvoie false. Voir aussi :falsecompareTocompareTo(Calendar)
-
compareTo
public int compareTo(Calendar anotherCalendar)
Compare les valeurs de temps représentées par deux objetsCalendar(décalage en millisecondes depuis l'Epoch).- Spécifié par :
compareTodans l'interfaceComparable<Calendar>- Paramètres
anotherCalendar- 待比较的Calendarà comparer. Résultat : la valeur0si le temps représenté par le paramètre est égal au temps représenté par cet objetCalendar; une valeur inférieure àCalendarsi le temps de cet objet0est antérieur au temps représenté par le paramètre ; une valeur supérieure àCalendarsi le temps de cet objet0est postérieur au temps représenté par le paramètre. ExceptionsNullPointerException- si l'objetCalendarestnullnull.IllegalArgumentException- si la valeur de temps de l'objetCalendarne peut pas être obtenue à cause de valeurs de calendrier invalides. Depuis la version : 1.5
-
add
public abstract void add(int field, int amount)Ajoute ou soustrait une durée spécifiée à un champ de calendrier donné, selon les règles du calendrier. Par exemple, pour soustraire 5 jours du temps actuel du calendrier, appelez la méthode suivante :add(Calendar.DAY_OF_MONTH, -5)。- Paramètres
字段- le champ de calendrier.amount- la quantité de date ou de temps à ajouter au champ. Voir aussi :roll(int,int),set(int,int)
-
roll
public abstract void roll(int field, boolean up)Ajoute ou soustrait (vers le haut ou vers le bas) une seule unité de temps à un champ donné sans modifier les champs plus grands. Par exemple, pour avancer la date actuelle d'un jour, appelez roll(Calendar.DATE, true). Lors d'un roulement sur le champ de l'année ou Calendar.YEAR, la valeur de l'année est modifiée dans une plage comprise entre 1 et la valeur renvoyée par l'appel degetMaximum(Calendar.YEAR). Lors d'un roulement sur le champ du mois ou Calendar.MONTH, d'autres champs, comme le jour, peuvent entrer en conflit et doivent être modifiés. Par exemple, rouler le mois de la date 01/31/96 donne 02/29/96. Lors d'un roulement sur le champ de l'heure ou Calendar.HOUR_OF_DAY, la valeur de l'heure est modifiée dans une plage de 0 à 23, en commençant à zéro.- Paramètres
字段- le champ de temps.up- indique si la valeur du champ de temps spécifié doit être augmentée ou diminuée. Utilisez true pour un roulement, sinon false. Voir aussi :add(int,int),set(int,int)
-
roll
public void roll(int field, int amount)Ajoute le montant (signé) spécifié au champ de calendrier spécifié, sans modifier les champs plus grands. Un nombre négatif indique un défilement vers le bas. Remarque :Calendarcette implémentation par défaut appelle de manière répétée la version qui défile d'une seule unitéroll(). Cela ne donne pas toujours le bon résultat. Par exemple, siDAY_OF_MONTHle champ vaut 31, un défilement vers février le fixe à 28. UneGregorianCalendarversion de cette fonction peut corriger ce problème. Les autres sous-classes doivent aussi fournir une surcharge pour obtenir le bon résultat.- Paramètres
字段- le champ de calendrier.amount- le montant signé à ajouter au champ de calendrier字段. Depuis la version : 1.2 Voir aussi :roll(int,boolean),add(int,int),set(int,int)
-
setTimeZone
public void setTimeZone(TimeZone value)
Définit le fuseau horaire avec la valeur de fuseau horaire donnée.- Paramètres
value- le fuseau horaire donné.
-
getTimeZone
public TimeZone getTimeZone()
Obtient le fuseau horaire.- Résultat : l'objet de fuseau horaire associé à ce calendrier.
-
setLenient
public void setLenient(boolean lenient)
Indique si l'interprétation des dates/heures est souple. Avec une interprétation souple, une date comme « 942 février 1996 » est traitée comme le 941e jour après le 1er février 1996. Avec une interprétation stricte (non souple), une telle date lève une exception. La valeur par défaut est souple.- Paramètres
lenient-truetrue pour activer le mode souple ;falsefalse pour le désactiver. Voir aussi :isLenient(),DateFormat.setLenient(boolean)
-
isLenient
public boolean isLenient()
Indique si l'interprétation des dates/heures est souple.- Résultat
truetrue si le mode d'interprétation de ce calendrier est souple ; sinonfalsefalse. Voir aussi :setLenient(boolean)
-
setFirstDayOfWeek
public void setFirstDayOfWeek(int value)
Définit le premier jour de la semaine ; par exemple,SUNDAY在美国,MONDAY在法国。- Paramètres
value- le premier jour de la semaine. Voir aussi :getFirstDayOfWeek(),getMinimalDaysInFirstWeek()
-
getFirstDayOfWeek
public int getFirstDayOfWeek()
Retourne le premier jour de la semaine. Par exemple,SUNDAY在美国,MONDAY在法国。- Résultat : le premier jour de la semaine. Voir aussi :
setFirstDayOfWeek(int),getMinimalDaysInFirstWeek()
-
setMinimalDaysInFirstWeek
public void setMinimalDaysInFirstWeek(int value)
Définit le nombre minimal de jours requis pour la première semaine de l'année. Par exemple, si la première semaine est définie comme celle contenant le premier jour du premier mois de l'année, appelez cette méthode avec la valeur 1. Si elle doit être une semaine complète, utilisez la valeur 7.- Paramètres
value- le nombre minimal de jours requis pour la première semaine de l'année. Voir aussi :getMinimalDaysInFirstWeek()
-
getMinimalDaysInFirstWeek
public int getMinimalDaysInFirstWeek()
Retourne le nombre minimal de jours requis pour la première semaine de l'année. Par exemple, si la première semaine est définie comme celle contenant le premier jour du premier mois de l'année, cette méthode retourne 1. Si le nombre minimal requis doit être une semaine complète, cette méthode retourne 7.- Résultat : le nombre minimal de jours requis pour la première semaine de l'année. Voir aussi :
setMinimalDaysInFirstWeek(int)
-
isWeekDateSupported
public boolean isWeekDateSupported()
Retourne si ceCalendarprend en charge les dates hebdomadaires. L'implémentation par défaut de cette méthode retournefalse。- Résultat
truesi ceCalendarprend en charge les dates hebdomadaires. Sinon,false. Depuis la version : 1.7 Voir aussi :getWeekYear(),setWeekDate(int,int,int),getWeeksInWeekYear()
-
getWeekYear
public int getWeekYear()
Retourne l'Calendar表示的Calendar. L'année hebdomadaire est synchronisée avec le cycle hebdomadaire. Le premier jour de la première semaine est le premier jour de la semaine. L'implémentation par défaut de cette méthode lève- Résultat : l'
Calendarannée de ceCalendar- Exceptions
UnsupportedOperationException- 如果此Calendarne prend en charge aucune numérotation des années hebdomadaires. Depuis la version : 1.7 Voir aussi :isWeekDateSupported(),getFirstDayOfWeek(),getMinimalDaysInFirstWeek()
-
setWeekDate
public void setWeekDate(int weekYear, int weekOfYear, int dayOfWeek)Définit la date de ceCalendaravec les spécificateurs de date donnés : année hebdomadaire, semaine et jour de la semaine. Contrairement à la méthodesettous les champs de calendrier et les valeurstimesont calculés au retour.Si
weekOfYearau-delà de la plage d'années de la semaine valideweekYear, cetteweekYear个weekOfYearajustée en mode permissif, ouIllegalArgumentExceptionlevée en mode non permissif.L'implémentation par défaut de cette méthode lève
UnsupportedOperationException。- Paramètres
weekYear- l'année de la semaine en coursweekOfYear- le numéro de semaine est basé surweekYear-
dayOfWeek- la valeur du jour de la semaine :DAY_OF_WEEKl'une des constantes du champ :SUNDAY, ...,SATURDAY. Exceptions IllegalArgumentException- si un spécificateur de date donné est invalide ou si un champ de calendrier est incohérent avec le spécificateur de date donné en mode non permissifUnsupportedOperationException- 如果此Calendarne prend en charge aucune numérotation des semaines. Depuis la version : 1.7 Voir aussi :isWeekDateSupported(),getFirstDayOfWeek(),getMinimalDaysInFirstWeek()
-
getWeeksInWeekYear
public int getWeeksInWeekYear()
Retourne le nombre de semainesCalendarde l'année de semaine représentée par ceCalendar. L'implémentation par défaut de cette méthode lèveUnsupportedOperationException。- Résultat : le nombre de semaines dans l'année de semaine. Exceptions
UnsupportedOperationException- 如果此Calendarne prend en charge aucune numérotation des semaines. Depuis la version : 1.7 Voir aussi :WEEK_OF_YEAR,isWeekDateSupported(),getWeekYear(),getActualMaximum(int)
-
getMinimum
public abstract int getMinimum(int field)
Retourne laCalendar实例的给定日历字段的Calendarinstance. La valeur minimale est définie comme la plus petite valeurgetretournée par la méthode pour toute valeur de temps possible. La valeur minimale dépend des paramètres spécifiques du système de calendrier de l'instance.- Paramètres
字段- le champ de calendrier. Résultat : la valeur minimale du champ de calendrier donné. Voir aussi :getMaximum(int),getGreatestMinimum(int),getLeastMaximum(int),getActualMinimum(int),getActualMaximum(int)
-
getMaximum
public abstract int getMaximum(int field)
renvoie la valeur maximale duCalendar实例的给定日历字段的Calendarinstance. La valeur maximale est définie comme la plus grande valeurgetrenvoyée par la méthode pour toute valeur de temps possible. La valeur maximale dépend des paramètres spécifiques du système de calendrier de l'instance.- Paramètres
字段- un champ de calendrier. Résultat la valeur maximale du champ de calendrier donné. Voir aussi :getMinimum(int),getGreatestMinimum(int),getLeastMaximum(int),getActualMinimum(int),getActualMaximum(int)
-
getGreatestMinimum
public abstract int getGreatestMinimum(int field)
renvoie la plus grande valeur minimale duCalendarchamp de calendrier donné pour cette instance. La plus grande valeur minimale est définie comme la plus grande valeurgetActualMinimum(int)renvoyée pour toute valeur de temps possible. La plus grande valeur minimale dépend des paramètres spécifiques du système de calendrier de l'instance.- Paramètres
字段- un champ de calendrier. Résultat la plus petite valeur minimale du champ de calendrier donné. Voir aussi :getMinimum(int),getMaximum(int),getLeastMaximum(int),getActualMinimum(int),getActualMaximum(int)
-
getLeastMaximum
public abstract int getLeastMaximum(int field)
renvoie la plus petite valeur maximale duCalendarchamp de calendrier donné pour cette instance. La plus petite valeur maximale est définie comme la plus petite valeurgetActualMaximum(int)renvoyée pour toute valeur de temps possible. La plus petite valeur maximale dépend des paramètres spécifiques du système de calendrier de l'instance. Par exemple,Calendarpour le système de calendrier grégorien, la méthode renvoie 28DAY_OF_MONTHpour le champ DAY_OF_MONTH, car le 28 est le dernier jour de février, le mois le plus court d'une année commune dans ce calendrier.- Paramètres
字段- un champ de calendrier. Résultat la plus petite valeur maximale du champ de calendrier donné. Voir aussi :getMinimum(int),getMaximum(int),getGreatestMinimum(int),getActualMinimum(int),getActualMaximum(int)
-
getActualMinimum
public int getActualMinimum(int field)
pour la valeur de temps de cetteCalendarinstance, renvoie la valeur minimale que le champ de calendrier spécifié peut prendre.CalendarL'implémentation par défaut de cette méthode utilise un algorithme itératif pour déterminer la valeur minimale réelle du champ de calendrier. Si possible, les sous-classes doivent la remplacer par une implémentation plus efficace. Dans de nombreux cas, elles renvoient simplementgetMinimum()。- Paramètres
字段- Champ de calendrier Résultat CeCalendarla valeur du champ de calendrier donné pour cette valeur temporelleCalendar- Disponible depuis : 1.2 Voir aussi :
getMinimum(int),getMaximum(int),getGreatestMinimum(int),getLeastMaximum(int),getActualMaximum(int)
-
getActualMaximum
public int getActualMaximum(int field)
Pour cetteCalendarvaleur temporelle, renvoie la valeur maximale possible du champ de calendrier spécifié.Calendar。 Par exemple,MONTHla valeur maximale réelle du champ est 12 certaines années et 13 d'autres années dans le calendrier hébraïque. L'implémentation par défaut de cette méthode utilise un algorithme itératif pour déterminer la valeur maximale réelle du champ de calendrier. Si possible, les sous-classes la remplacent par une implémentation plus efficace.- Paramètres
字段- champ de calendrier résultat, ceCalendarpour la valeur temporelle de ceCalendar- Depuis : 1.2 Voir aussi :
getMinimum(int),getMaximum(int),getGreatestMinimum(int),getLeastMaximum(int),getActualMinimum(int)
-
clone
public Object clone()
Crée et renvoie une copie de cet objet.
-
toString
public String toString()
Renvoie une représentation sous forme de chaîne de ce calendrier. Cette méthode sert uniquement au débogage. Le format de la chaîne renvoyée varie selon l'implémentation. La chaîne renvoyée peut être vide, mais elle ne peut pas êtrenull。
-
-