模块  java.base
Paquetage java.util

Classe 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, appelezsetMé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.

    QuandCalendarEn 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 obtention

    WEEK_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,

    Calendarla priorité est donnée aux champs de calendrier définis le plus récemment. Voici les combinaisons par défaut des champs de calendrier. La combinaison la plus récente déterminée par les champs individuels définis en dernier sera utilisée.

    Pour les champs de date :

     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
     
    Pour les champs d'heure de la journée :
     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, dansGregorianCalendar le 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 :

    1. 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.
    2. 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. UtilisezDateFormatpour 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érezGregorianCalendarinitialement 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 fieldf after the call minus the value of field f before the call is delta, modulo any overflow that has occurred in field fUn 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.f is changed or other constraints, such as time zone offset changes, then its value is adjusted to be as close as possible to its expected value. A smaller field represents a smaller unit of time. HOUR is a smaller field than DAY_OF_MONTH. No adjustment is made to smaller fields that are not expected to be invariant. The calendar system determines what fields are expected to be invariant.

    De plus, contrairement àset(), add()force le recalcul immédiat des millisecondes du calendrier et de tous les champs.

    Par exemple : considérezGregorianCalendarinitialement 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_MONTH est un champ plus grand que HOUR.

    Exemple : consultezGregorianCalendar.roll(int, int).

    Mode d'utilisation. Pour illustrer le comportement deadd()和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 class  Calendar.Builder
      Calendar.BuilderUtilisée pour créer un Calendar 。
    • 构造方法摘要

      构造方法  
      变量 构造器 Description
      protected Calendar()
      Construit un calendrier avec le fuseau horaire par défaut et lesFORMATparamètres régionaux par défaut.
      protected Calendar​(TimeZone zone, Locale aLocale)
      Construit un calendrier avec le fuseau horaire et les paramètres régionaux spécifiés.
    • 方法摘要

      所有方法  静态方法  实例方法 抽象方法  具体的方法 
      变量和类型 方法 Description
      abstract void add​(int field, int amount)
      Ajoute ou soustrait la durée spécifiée au champ de calendrier donné, selon les règles du calendrier.
      boolean after​(Object when)
      Retourne si ceCalendar是否表示指定的 Objectreprésenté par l'objet spécifié.
      boolean before​(Object when)
      Retourne si ceCalendar是否表示指定的 Objectreprésenté par l'objet spécifié.
      void clear()
      Définit toutes les valeurs des champs de calendrier et les valeurs temporelles (décalage en millisecondes depuis l'Epoch)Calendarnon définies de ce
      void clear​(int field)
      Définit les valeurs du champ de calendrier donné et les valeurs temporelles (décalage en millisecondes depuis l'Epoch)Calendarnon définies de ce
      Object clone()
      Crée et retourne une copie de cet objet.
      int compareTo​(Calendar anotherCalendar)
      Compare les valeurs temporelles (décalage en millisecondes depuis l'Epoch)Calendarreprésentées par deux objets
      protected void complete()
      Remplit tous les champs non définis dans les champs de calendrier.
      protected abstract void computeFields()
      Convertit la valeur temporelle actuelle en millisecondes entimevaleurs des champs de calendrierfields[] 。
      protected abstract void computeTime()
      Convertit les valeurs actuelles des champs de calendrierfields[]en valeur temporelle en millisecondestime 。
      boolean equals​(Object obj)
      Compare ceCalendaravec l'objet Object 。
      int get​(int field)
      Retourne la valeur du champ de calendrier donné.
      int getActualMaximum​(int field)
      Étant donnée la valeur temporelle de ceCalendar, retourne la Calendar 。
      int getActualMinimum​(int field)
      Étant donnée la valeur temporelle de ceCalendar, retourne la Calendar 。
      static Set<String> getAvailableCalendarTypes()
      Retourne unSetnon modifiable contenant tous les types de calendrier Calendarsupportés par l'environnement d'exécution.
      static Locale[] getAvailableLocales()
      Retourne le tableau de tous les paramètres régionaux,getInstancela méthode getInstanceretourne une instance localisée.
      String getCalendarType()
      Retourne le type de calendrierCalendarde cette instance.
      String getDisplayName​(int field, int style, Locale locale)
      Retourne la représentation sous forme de chaînestyle和 locale日历 字段donnés locale 。
      Map<String,​Integer> getDisplayNames​(int field, int style, Locale locale)
      Retourne unMapcontenant tous les noms du style和 locale日历 字段所有名称及其对应的字段值。
      int getFirstDayOfWeek()
      Retourne le premier jour de la semaine. Par exemple,SUNDAY在美国, MONDAY在法国。
      abstract int getGreatestMinimum​(int field)
      Retourne la plus grande valeur minimale du champ de calendrier donnéCalendarde cette instance.
      static Calendar getInstance()
      Retourne un calendrier avec le fuseau horaire et les paramètres régionaux par défaut.
      static Calendar getInstance​(Locale aLocale)
      Retourne un calendrier avec le fuseau horaire par défaut et les paramètres régionaux spécifiés.
      static Calendar getInstance​(TimeZone zone)
      Retourne un calendrier avec le fuseau horaire spécifié et les paramètres régionaux par défaut.
      static Calendar getInstance​(TimeZone zone, Locale aLocale)
      Retourne un calendrier avec le fuseau horaire et les paramètres régionaux spécifiés.
      abstract int getLeastMaximum​(int field)
      Retourne la plus petite valeur maximale du champ de calendrier donnéCalendarde cette instance.
      abstract int getMaximum​(int field)
      Retourne leCalendar实例的给定日历字段的 Calendar 。
      int getMinimalDaysInFirstWeek()
      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 int getMinimum​(int field)
      Retourne leCalendar实例的给定日历字段的 Calendar 。
      Date getTime()
      Retourne un objetDatequi représente la valeur temporelle de ce Calendar(décalage en millisecondes par rapport à l'Epoch).
      long getTimeInMillis()
      Retourne la valeur temporelle de ce Calendar en millisecondes.
      TimeZone getTimeZone()
      Retourne le fuseau horaire.
      int getWeeksInWeekYear()
      Retourne la semaine de l'annéeCalendarreprésentée par ce Calendar 。
      int getWeekYear()
      Retourne laCalendarreprésentée par Calendar 。
      int hashCode()
      Retourne le code de hachage de ce calendrier.
      protected int internalGet​(int field)
      Retourne la valeur du champ de calendrier donné.
      boolean isLenient()
      Indique si l'interprétation de la date et de l'heure est souple.
      boolean isSet​(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.
      boolean isWeekDateSupported()
      Indique si ceCalendarprend en charge les dates hebdomadaires.
      abstract void roll​(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.
      void roll​(int field, int amount)
      Ajoute le montant spécifié (signé) au champ de calendrier donné sans modifier les champs plus grands.
      void set​(int field, int value)
      Définit le champ de calendrier donné à la valeur donnée.
      void set​(int year, int month, int date)
      Définit les valeurs des champs de calendrierYEAR , MONTH和 DAY_OF_MONTH 。
      void set​(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 。
      void set​(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 。
      void setFirstDayOfWeek​(int value)
      Définit le premier jour de la semaine. Par exemple,SUNDAY在美国, MONDAY在法国。
      void setLenient​(boolean lenient)
      Indique si l'interprétation de la date et de l'heure est souple.
      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.
      void setTime​(Date date)
      Définit l'heure de ce calendrier avec leDatedonné.
      void setTimeInMillis​(long millis)
      Définit l'heure actuelle de ce Calendar à partir de la valeur long donnée.
      void setTimeZone​(TimeZone value)
      Définit le fuseau horaire avec la valeur de fuseau horaire donnée.
      void setWeekDate​(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.
      Instant toInstant()
      Convertit cet objet enInstant.
      String toString()
      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.
        Voir aussi : Valeur de champ constante
      • 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.
        Voir aussi : valeurs de champ constantes
      • 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 。
        Voir aussi :
        SUNDAY,MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY,SATURDAY, valeurs constantes de champ
      • 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 。
        .
        AMVoir aussi :PM,HOUR, valeur de champ constante
      • 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.
        Voir aussi : valeur de champ constante
      • 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.
        Voir aussi : valeur de champ constante
      • 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.
        Voir aussi : valeur de champ constante
      • ZONE_OFFSET

        public static final int ZONE_OFFSET
        get和setle numéro de champ indique le décalage brut par rapport à GMT (en millisecondes). Si

        TimeZonela 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

        cette instance.
      • DST_OFFSET

        public static final int DST_OFFSET
        get和setet

        TimeZoneSi 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.

        Voir aussi : valeurs des champs constants
      • FIELD_COUNT

        public static final int FIELD_COUNT
        get和setNombre de champs distincts reconnus. Les numéros de champs vont de0..FIELD_COUNT-1 。
        Voir aussi : valeurs des champs constants
      • SUNDAY

        public static final int SUNDAY
        Valeur du champDAY_OF_WEEK字段的值。
        Voir aussi : valeurs des champs constants
      • MONDAY

        public static final int MONDAY
        DAY_OF_WEEKValeur du champ représentant le lundi.
        Voir aussi : valeurs des champs constants
      • TUESDAY

        public static final int TUESDAY
        Valeur du champDAY_OF_WEEK字段的值。
        Voir aussi : valeurs des champs constants
      • WEDNESDAY

        public static final int WEDNESDAY
        DAY_OF_WEEKValeur du champ représentant le mercredi.
        Voir aussi : valeurs des champs constants
      • THURSDAY

        public static final int THURSDAY
        DAY_OF_WEEKValeur du champ représentant le jeudi.
        Voir aussi : valeurs des champs constants
      • FRIDAY

        public static final int FRIDAY
        Valeur du champDAY_OF_WEEK字段的值。
        Voir aussi : valeurs des champs constants
      • SATURDAY

        public static final int SATURDAY
        Valeur du champDAY_OF_WEEK字段的值。
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : valeurs des champs constants
      • 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.
        Voir aussi : 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()
      • Calendar

        protected Calendar​(TimeZone zone,
                           Locale aLocale)
        Construit un calendrier avec le fuseau horaire et les paramètres régionaux spécifiés.
        Paramètres
        zone- le fuseau horaire à utiliser
        aLocale- les paramètres régionaux pour les données de semaine
    • 方法详细信息

      • 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 à utiliser
        aLocale- 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.
      • 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 : appelerDateavec

        Date(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é. Exceptions
        ArrayIndexOutOfBoundsException - 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 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 champs

        HOUR_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ésultat
        truetrue 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 ce

        Calendar是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 calendrierDateFormatSymbolspour lesquels un nom est donnélocale 。

        Paramètres
        字段- le champ de calendrier dont on veut la représentation sous forme de chaîne
        style- 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é par localeest ignoré) Résultat la représentation sous forme de chaîne du
        字段donné dans le style字符串表示 style , ou style , null. Exceptions
        IllegalArgumentException - 如果 字段或 style无效,或者此 Calendarn'est pas indulgent et qu'un champ de calendrier a une valeur invalide
        NullPointerException - 如果 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 la

        Map 。

        D'autres valeurs de champs de calendrier peuvent être prises en compte pour déterminer un ensemble de noms d'affichage. Par exemple, si ceCalendarest 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 dansDateFormatSymbols. 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és
        style- 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'affichage style和 localeavec leurs valeurs de champ, ou nullsi 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 invalide
        NullPointerException - 如果 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 instance

        Calendar. 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 untrue du 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. Les

        Calendarparamètres sont les valeurs représentées parisLenient , getFirstDayOfWeek , getMinimalDaysInFirstWeek和getTimeZone. Si un paramètre diffère entre les deuxCalendar, cette méthode retournefalse 。

        UtilisationcompareToLa méthode compare uniquement les valeurs temporelles.

        Remplacement :
        equals类 Object
        Paramètres
        obj- l'objet à comparer. Résultat
        truetrue si cet objet est égal àobj; sinonfalse. Voir aussi :
        Object.hashCode(),HashMap
      • before

        public boolean before​(Object when)
        Retourne si ceCalendar是否表示指定的Objectspécifié. Cette méthode est équivalente à :
           compareTo(when) < 0  
        当且仅当when是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; sinon
        compareTo(Calendar)
      • after

        public boolean after​(Object when)
        Retourne si ceCalendar是否表示指定的Objectspécifié. Cette méthode est équivalente à :
           compareTo(when) > 0  
        当且仅当when是Calendar. Sinon, la méthode retournefalse 。
        Paramètres
        when - 待比较的 Object
        Résultat
        true如果此Calendar的时间when于when; sinon renvoie false. Voir aussi :falsecompareTo
        compareTo(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 :
        compareTo dans l'interface Comparable<Calendar>
        Paramètres
        anotherCalendar - 待比较的 Calendarà comparer. Résultat : la valeur
        0si 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. Exceptions
        NullPointerException - si l'objet Calendarest nullnull.
        IllegalArgumentException - si la valeur de temps de l'objet Calendarne 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 de

        getMaximum(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 retourne

        false 。

        Résultat
        truesi ceCalendarprend en charge les dates hebdomadaires. Sinon,false. Depuis la version : 1.7 Voir aussi :
        getWeekYear(),setWeekDate(int,int,int),getWeeksInWeekYear()
      • 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éthode

        settous les champs de calendrier et les valeurstimesont calculés au retour.

        SiweekOfYearau-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èveUnsupportedOperationException 。

        Paramètres
        weekYear- l'année de la semaine en cours
        weekOfYear - le numéro de semaine est basé sur weekYear
        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 permissif
        UnsupportedOperationException - 如果此 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ève

        UnsupportedOperationException 。

        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 28 DAY_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 simplement

        getMinimum() 。

        Paramètres
        字段- Champ de calendrier Résultat Ce
        Calendarla valeur du champ de calendrier donné pour cette valeur temporelle Calendar
        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, ce
        Calendarpour la valeur temporelle de ce Calendar
        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.
        Redéfini par :
        cloneDans la classe Object
        Résultat : une copie de cet objet. Voir aussi :
        Cloneable
      • 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 。
        Redéfini par :
        toStringDans la classe Object
        Résultat La représentation sous forme de chaîne de ce calendrier.
      • toInstant

        public final Instant toInstant()
        Convertit cet objet en unInstant. La conversion crée un

        Instant qui représente le même point sur la ligne de temps que ceCalendar.

        Résultat Un instant représentant le même point sur la ligne de temps. Depuis la version : 1.8