模块  java.base
Пакет java.util

Class Calendar

  • Все реализованные интерфейсы
    Serializable , Cloneable , Comparable<Calendar>
    Известные прямые подклассы:
    GregorianCalendar

    public abstract class Calendar
    extends Object
    implements Serializable, Cloneable, Comparable<Calendar>
    УказанныйCalendarкласс является абстрактным классом. Он содержит методы для преобразования между моментом времени и набором полейcalendar fieldsНапримерYEAR , MONTH , DAY_OF_MONTH , HOURи т. д., а также для работы с полями календаря, например для получения даты следующей недели.

    protected 。

    Как и другие классы, чувствительные к локали,Calendarпредоставляет статический методgetInstanceдля получения универсального объекта этого типа.Calendar的getInstanceкласса возвращаетCalendarобъект, календарные поля которого инициализированы текущей датой и временем:

         Calendar rightNow = Calendar.getInstance();
     

    CalendarОбъект может формировать все значения календарных полей, необходимые для форматирования даты и времени на конкретном языке и в конкретном стиле календаря (например, японский — григорианский, японский — традиционный).CalendarКласс определяет диапазоны значений и смысл некоторых возвращаемых календарных полей. Например, для первого месяца календарной системы все календари имеют значениеMONTH == JANUARY. Другие значения определяются конкретными подклассами, напримерERA. Подробнее смотрите документацию по каждому полю и по подклассам.

    Получение и установка значений календарных полей

    Значения календарных полей устанавливаются вызовом методаset.CalendarУстановленные значения полей не интерпретируются до тех пор, пока не потребуется вычислить значение времени (миллисекунды от эпохи) или значения календарных полей. Вызовыget , getTimeInMillis , getTime , add和rollзапускают такие вычисления.

    Льготный режим

    CalendarКласс интерпретирует календарные поля в двух режимах: льготном и нелъготном. КогдаCalendarработает в льготном режиме, он принимает более широкий диапазон значений календарных полей, чем создаёт. КогдаCalendarпересчитывает возвращаемыеCalendarзначения календарных полей, он get()нормализует все календарные поля. Например, льготныйGregorianCalendar解释MONTH == JANUARY , DAY_OF_MONTH == 32как 1 февраля.

    КогдаCalendarработает в нелъготном режиме, он выбрасывает исключение при любом несоответствии в календарных полях. Например,GregorianCalendarвсегда создаёт значениеDAY_OF_MONTHв диапазоне от 1 до длины месяца. Если какое-либо значение поля установлено вне диапазона, нелъготныйGregorianCalendarвыбрасывает исключение при вычислении времени или значений календарных полей.

    Первая неделя

    CalendarКласс определяет семидневную рабочую неделю, специфичную для локали, двумя параметрами: первым днём недели и минимальным числом дней в первой неделе (от 1 до 7). При созданииCalendarэти числа берутся из данных ресурсов локали или из самой локали. Если указанная локаль содержит Unicode-расширения "fw" и/или "rg", первый день недели берётся по этим расширениям. Если указаны и "fw", и "rg", значение из расширения "fw" заменяет неявное значение из расширения "rg". Их также можно задать явно методами установки значений. При установке или получении

    WEEK_OF_MONTH或WEEK_OF_YEARполей, CalendarНеделю месяца или года необходимо определить как точку отсчёта. Первая неделя месяца или года определяется как самый ранний семидневный период, который начинаетсяgetFirstDayOfWeek()и содержит не менееgetMinimalDaysInFirstWeek()дней этого месяца или года. Недели до первой недели нумеруются как ..., -1, 0. Недели 2, 3, ... следуют за ней. Обратите внимание, чтоget()возвращаемый нормализованный номер может отличаться. Например, конкретныйCalendarподкласс может обозначить неделю перед первой неделей года как последнюю неделюn周。

    Разрешение полей календаря

    При вычислении даты и времени из полей календаря информации может быть недостаточно. Например, указаны год и месяц, но нет дня. Информация также может быть противоречивой. Например, 15 июля 1996 года названо вторником по григорианскому календарю. На самом деле это был понедельник.CalendarЗначения полей календаря разбираются для определения даты и времени следующим образом. Если значения полей календаря конфликтуют,

    Calendarприоритет получают поля, установленные последними. Ниже приведены комбинации полей календаря по умолчанию. Будет использована самая последняя комбинация, определяемая полями, установленными последними.

    Для полей даты:

     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
     

    Если значение какого-либо поля календаря не задано в выбранной комбинации полей, тоCalendarиспользуется его значение по умолчанию. Значение по умолчанию для каждого поля зависит от конкретной календарной системы. Например, вGregorianCalendar значение поля по умолчанию совпадает с началом эпохи, то естьYEAR = 1970 , MONTH = JANUARY , DAY_OF_MONTH = 1и так далее.

    Примечание. Существуют возможные неоднозначности при интерпретации некоторых особых времён. Они разрешаются следующим образом:

    1. 23:59 — последняя минута дня, 00:00 — первая минута следующего дня. Поэтому 31 декабря 1999 года 23:59 < 1 января 2000 года 00:00 < 1 января 2000 года 00:01.
    2. Хотя исторически это неточно, полночь относится к «AM», а полдень к «PM». Поэтому в один и тот же день 12:00 AM (полночь) < 12:01 AM, а 12:00 PM (полдень) < 12:01 PM.

    Строки формата даты или времени не являются частью определения календаря, потому что пользователь должен иметь возможность изменять или переопределять их во время выполнения. ИспользуйтеDateFormatдля форматирования дат.

    Манипулирование полями

    : поля календаря можно изменять тремя методами:set() , add()和roll().

    set(f, value)Метод изменяет поле календаряf至value. Кроме того, он устанавливает внутреннюю переменную-член, указывающую, что поле календаряfизменено. Хотя поле календаряfизменяется немедленно, значение времени календаря в миллисекундах не пересчитывается до следующего вызоваget() , getTime() , getTimeInMillis() , add() ,或roll(). Поэтому несколько вызововset()не запускают несколько лишних вычислений. В результате изменения поля календаря черезset()другие поля календаря также могут измениться. Это зависит от полей календаря, их значений и календарной системы. Кроме того,get(f)Не обязательно возвращаетvalueчерез установку телефона доsetметода. Поля календаря пересчитаны после вызова. Конкретное поведение определяет конкретный класс календаря.

    Например: рассмотримGregorianCalendarизначально установленный на 31 августа 1999 года вызовом set(Calendar.MONTH, Calendar.SEPTEMBER)установить день на 31 сентября 1999 года. Это временное внутреннее представление разрешается в 1 октября 1999 года, еслиgetTime()затем вызвать. Однако при вызовеset(Calendar.DAY_OF_MONTH, 30)до вызоваgetTime()дата устанавливается на 30 сентября 1999 года, потому чтоset()после этого пересчёта не было.

    add(f, delta)增加delta到现场f. Это эквивалентно вызову с двумя корректировкамиset(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 fПереполнение возникает, когда значение поля выходит за пределы своего диапазона. В этом случае следующее большее поле увеличивается или уменьшается. Значение поля корректируется обратно в свой диапазон.

    Добавьте правило 2. Пусть меньшее поле должно быть инвариантным. Но оно не может равняться прежнему значению. Причина — изменение минимума или максимума поля.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.

    Кроме того, в отличие отset(), add()принудительно пересчитывает миллисекунды календаря и все поля немедленно.

    Например: рассмотримGregorianCalendarизначально установленный на 31 августа 1999 года вызовом add(Calendar.MONTH, 13)установить календарь на 30 сентября 2000 года. Add rule 1 устанавливаетMONTHполе на сентябрь, потому что добавление 13 месяцев даёт сентябрь следующего года. ПосколькуDAY_OF_MONTHне может быть в сентябреGregorianCalendar, поэтому Add rule 2 устанавливаетDAY_OF_MONTHна ближайшее возможное значение. Хотя это меньшее поле,DAY_OF_WEEKправило 2 не корректируетDAY_OF_WEEK, потому что при изменении месяца вGregorianCalendarоно, как ожидается, изменится.

    roll(f, delta)增加delta到现场fне изменяет большие поля. Это эквивалентно вызову со следующей корректировкойadd(f, delta) :

    Правило roll . Большие поля не изменяются после вызова. Большое поле представляет более крупную единицу времени.DAY_OF_MONTH является большим полем по отношению к HOUR.

    Пример : смотритеGregorianCalendar.roll(int, int).

    Режим использования . Чтобы понять поведениеadd()和roll(), рассмотрите компонент интерфейса с кнопками увеличения и уменьшения месяца, дня и года, а также с базовымGregorianCalendar. Если интерфейс читает 31 января 1999 года и пользователь нажимает кнопку увеличения месяца, что он должен показать? Если базовая реализация используетset() , она может показать 3 марта 1999 года. Лучший результат — 28 февраля 1999 года. Кроме того, если пользователь снова нажимает кнопку увеличения месяца, должно быть 31 марта 1999 года, а не 28 марта 1999 года. Сохраняя исходную дату и используяadd()或roll(), в зависимости от того, должны ли затрагиваться большие поля, интерфейс работает так, как большинство пользователей ожидает интуитивно.

    Начиная с версии: 1.1 Смотрите также:
    System.currentTimeMillis(),Date,GregorianCalendar,TimeZone,DateFormat, Serialized Form
    • 嵌套类汇总

      Вложенный класс Переменные и типы Класс Описание
      static class  Calendar.Builder
      Calendar.BuilderИспользуется для создания Calendar 。
    • 构造方法摘要

      构造方法  
      变量 构造器 Описание
      protected Calendar()
      Используйте часовой пояс по умолчанию и настройки по умолчанию.FORMATЛокаль создаёт календарь.
      protected Calendar​(TimeZone zone, Locale aLocale)
      Создаёт календарь с указанным часовым поясом и региональными настройками.
    • 方法摘要

      Все методы Статические методы Методы экземпляра Абстрактные методы Конкретные методы Переменные и типы Метод Описание
      abstract void add​(int field, int amount)
      Метод добавляет или вычитает указанный интервал времени из заданного поля календаря по правилам календаря.
      boolean after​(Object when)
      Вернуться назадCalendar是否表示指定的 ObjectВремя после указанного времени.
      boolean before​(Object when)
      Возвращает значение этогоCalendar是否表示指定的 Objectвременем, которое он представляет.
      void clear()
      Устанавливает все значения полей календаря и значения времени этогоCalendarобъекта как неопределённые (смещение в миллисекундах от Epoch).
      void clear​(int field)
      Устанавливает заданные значения полей календаря и значения времени этогоCalendarобъекта как неопределённые (смещение в миллисекундах от Epoch).
      Object clone()
      Создаёт и возвращает копию этого объекта.
      int compareTo​(Calendar anotherCalendar)
      Сравнивает значения времени (смещение в миллисекундах от Epoch), представленные двумяCalendarобъектами.
      protected void complete()
      Заполните все незаданные поля в календаре.
      protected abstract void computeFields()
      Преобразование текущего значения времени в миллисекундах вtimeзначение поля календаряfields[] 。
      protected abstract void computeTime()
      boolean equals​(Object obj)
      Возьмите этотCalendarС указанным Object 。
      int get​(int field)
      Возвращает значение заданного поля календаря.
      int getActualMaximum​(int field)
      Для данногоCalendarзначения времени возвращает максимальное значение, которое может иметь указанное поле календаря Calendar 。
      int getActualMinimum​(int field)
      Для данногоCalendarзначения времени возвращает максимальное значение, которое может иметь указанное поле календаря Calendar 。
      static Set<String> getAvailableCalendarTypes()
      Возвращает неизменяемыйSetобъект, который содержит все типы календарей, поддерживаемые Calendarв среде выполнения.
      static Locale[] getAvailableLocales()
      Возвращает массив всех локалей,getInstanceметод может getInstanceвозвращать локализованный экземпляр.
      String getCalendarType()
      Возвращает тип календаряCalendarэтого объекта.
      String getDisplayName​(int field, int style, Locale locale)
      Возвращает строковое представлениеstyle和 locale日历 字段в виде строки locale 。
      Map<String,​Integer> getDisplayNames​(int field, int style, Locale locale)
      ВозвращаетMapкоторый содержит все имена заданного style和 locale日历 字段и соответствующие им значения полей.
      int getFirstDayOfWeek()
      Возвращает первый день недели, например,SUNDAY在美国, MONDAY在法国。
      abstract int getGreatestMinimum​(int field)
      Возвращает наибольшее минимальное значение заданного календарного поля этогоCalendarэкземпляра.
      static Calendar getInstance()
      Получает календарь с часовым поясом и региональными настройками по умолчанию.
      static Calendar getInstance​(Locale aLocale)
      Получает календарь с часовым поясом по умолчанию и указанными региональными настройками.
      static Calendar getInstance​(TimeZone zone)
      Получает календарь с указанным часовым поясом и региональными настройками по умолчанию.
      static Calendar getInstance​(TimeZone zone, Locale aLocale)
      Получает календарь с указанным часовым поясом и региональными настройками.
      abstract int getLeastMaximum​(int field)
      Возвращает минимальное максимальное значениеCalendarзаданного поля календаря этого экземпляра.
      abstract int getMaximum​(int field)
      ВозвращаетCalendar实例的给定日历字段的 Calendar 。
      int getMinimalDaysInFirstWeek()
      Получает минимальное количество дней, необходимое для первой недели года. Например, если первая неделя определена как неделя, содержащая первый день первого месяца года, метод возвращает 1.
      abstract int getMinimum​(int field)
      Возвращает значениеCalendar实例的给定日历字段的 Calendar 。
      Date getTime()
      Возвращает объект,Dateпредставляющий значение времени этого Calendar(смещение в миллисекундах от Epoch).
      long getTimeInMillis()
      Возвращает значение времени этого Calendar в миллисекундах.
      TimeZone getTimeZone()
      Получает часовой пояс.
      int getWeeksInWeekYear()
      Возвращает неделю в неделе,Calendarпредставленную этим Calendar 。
      int getWeekYear()
      Возвращает этоCalendarобозначает Calendar 。
      int hashCode()
      Возвращает хеш-код этого календаря.
      protected int internalGet​(int field)
      Возвращает значение заданного поля календаря.
      boolean isLenient()
      Указывает, допускает ли интерпретация даты/времени отклонения.
      boolean isSet​(int field)
      Определяет, имеет ли заданное поле календаря установленное значение, включаяgetСлучай, когда вызов метода запускает вычисление и установку значения внутреннего поля.
      boolean isWeekDateSupported()
      Возвращает этоCalendarПоддерживает ли дату недели.
      abstract void roll​(int field, boolean up)
      Добавляет или вычитает (вверх/вниз) одну единицу времени в заданном поле времени. Большие поля не изменяются.
      void roll​(int field, int amount)
      Добавляет указанную (со знаком) величину к указанному полю календаря. Большие поля не изменяются.
      void set​(int field, int value)
      Устанавливает заданное поле календаря в заданное значение.
      void set​(int year, int month, int date)
      Устанавливает значение полей календаряYEAR , MONTH和 DAY_OF_MONTH 。
      void set​(int year, int month, int date, int hourOfDay, int minute)
      Устанавливает значение поля календаряYEAR , MONTH , DAY_OF_MONTH , HOUR_OF_DAY和 MINUTE 。
      void set​(int year, int month, int date, int hourOfDay, int minute, int second)
      Установите значение в полеYEAR , MONTH , DAY_OF_MONTH , HOUR_OF_DAY , MINUTE和 SECOND 。
      void setFirstDayOfWeek​(int value)
      Задаёт первый день недели. Например,SUNDAY在美国, MONDAY在法国。
      void setLenient​(boolean lenient)
      Указывает, строго ли интерпретируется дата/время.
      void setMinimalDaysInFirstWeek​(int value)
      Задаёт минимальное число дней в первой неделе года. Например, если первая неделя содержит первый день первого месяца года, вызовите этот метод со значением 1.
      void setTime​(Date date)
      Использует заданныйDateустанавливает время этого календаря.
      void setTimeInMillis​(long millis)
      Устанавливает текущее время этого Calendar из заданного значения long.
      void setTimeZone​(TimeZone value)
      Устанавливает часовой пояс по заданному значению.
      void setWeekDate​(int weekYear, int weekOfYear, int dayOfWeek)
      Устанавливает дату этогоCalendarобъекта с помощью заданного спецификатора даты: год, месяц и день недели.
      Instant toInstant()
      Преобразует этот объект вInstant.
      String toString()
      Возвращает строковое представление этого календаря.
    • 字段详细信息

      • ERA

        public static final int ERA
        get和setНомер поля обозначает эру, например AD или BC в юлианском календаре. Это значение зависит от календаря. Смотрите документацию подкласса.
        См. также:
        GregorianCalendar.AD,GregorianCalendar.BC, Значения константных полей
      • YEAR

        public static final int YEAR
        get和setНомер поля обозначает год. Это значение зависит от календаря. Смотрите документацию подкласса.
        См. также: Значения константных полей
      • MONTH

        public static final int MONTH
        get和setНомер поля обозначает месяц. Это значение зависит от календаря. Первый месяц в григорианском и юлианском календарях равенJANUARY, то есть 0. Последний зависит от количества месяцев в году.
        См. также:
        JANUARY,FEBRUARY,MARCH,APRIL,MAY,JUNE,JULY,AUGUST,SEPTEMBER,OCTOBER,NOVEMBER,DECEMBER,UNDECIMBER, Значения константных полей
      • WEEK_OF_YEAR

        public static final int WEEK_OF_YEAR
        get和setНомер поля обозначает номер недели в текущем году. Первая неделя года, определённаяgetFirstDayOfWeek()和getMinimalDaysInFirstWeek(), имеет значение 1. Подкласс определяет количество дней до первой недели года.WEEK_OF_YEAR的值。
        Смотрите также:
        getFirstDayOfWeek(),getMinimalDaysInFirstWeek(), значения констант полей
      • WEEK_OF_MONTH

        public static final int WEEK_OF_MONTH
        get和set字段编号表示getв месяце. Первая неделя месяца, определённаяgetFirstDayOfWeek()和getMinimalDaysInFirstWeek()имеет значение 1. Подкласс определяет значение дней до первой недели месяцаWEEK_OF_MONTH 。
        Смотрите также:
        getFirstDayOfWeek(),getMinimalDaysInFirstWeek(), значения констант полей
      • DATE

        public static final int DATE
        get和setномер поля обозначает день месяца. ЭтоDAY_OF_MONTHсиноним. Первый день месяца имеет значение 1.
        Смотрите также:
        DAY_OF_MONTH, значения констант полей
      • DAY_OF_MONTH

        public static final int DAY_OF_MONTH
        get和setномер поля обозначает день месяца. ЭтоDATEсиноним. Первый день месяца имеет значение 1.
        Смотрите также:
        DATE, значения констант полей
      • DAY_OF_YEAR

        public static final int DAY_OF_YEAR
        get和setномер поля обозначает номер дня в году. Первый день года имеет значение 1.
        Смотрите также: значения констант полей
      • DAY_OF_WEEK

        public static final int DAY_OF_WEEK
        get和setномер поля обозначает день недели. Значения этого поляSUNDAY , MONDAY , TUESDAY , WEDNESDAY , THURSDAY , FRIDAY和SATURDAY 。
        См. также:
        SUNDAY,MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY, значения констант полейSATURDAY , 常数字段值
      • DAY_OF_WEEK_IN_MONTH

        public static final int DAY_OF_WEEK_IN_MONTH
        get和setномер поля, обозначающий порядковый номер дня недели в месяце. Вместе с полемDAY_OF_WEEKон однозначно определяет день в месяце. В отличие отWEEK_OF_MONTH和WEEK_OF_YEARзначение этого поля не зависит отgetFirstDayOfWeek()或getMinimalDaysInFirstWeek().DAY_OF_MONTH 1至7доDAY_OF_WEEK_IN_MONTH 1всегда соответствует8到14отDAY_OF_WEEK_IN_MONTH 2доDAY_OF_WEEK_IN_MONTH 0表示DAY_OF_WEEK_IN_MONTH 1и так далее. ЗначениеDAY_OF_WEEK = SUNDAY, DAY_OF_WEEK_IN_MONTH = -1обозначает неделю передDAY_OF_WEEK_IN_MONTH -1. Отрицательные значения отсчитываются от конца месяца, поэтому последнее воскресенье месяца обозначается какDAY_OF_WEEK_IN_MONTH 5和4будет пересекаться с
        и
        DAY_OF_WEEKв конце. См. также:WEEK_OF_MONTH,
      • AM_PM

        public static final int AM_PM
        get和set字段编号表示HOURномер поля, показывающий, находится лиAM_PM是PM 。
        . См. также:
        AM,PM,HOUR, значение константного поля
      • HOUR

        public static final int HOUR
        get和setномер поля обозначает час до или после полудня.HOURИспользуется для 12-часового формата (0 - 11). Полдень и полночь обозначаются 0, а не 12. Например, в 10:04:15.250 PMHOURравно 10.
        См. также:
        AM_PM,HOUR_OF_DAY, значение константного поля
      • HOUR_OF_DAY

        public static final int HOUR_OF_DAY
        get和setномер поля обозначает час суток.HOUR_OF_DAYИспользуется для 24-часового формата. Например, в 10:04:HOUR_OF_DAYравно 22.
        См. также:
        HOUR, значение константного поля
      • MINUTE

        public static final int MINUTE
        get和setномер поля обозначает минуту в пределах часа. Например, в 10:04 PMMINUTEравно 4.
        См. также: значение константного поля
      • SECOND

        public static final int SECOND
        get和setномер поля обозначает секунду в пределах минуты. Например, в 10:04 PMSECONDравно 15.
        См. также: значение константного поля
      • MILLISECOND

        public static final int MILLISECOND
        get和setномер поля обозначает миллисекунды в пределах секунды. Например, в 10:04 PMMILLISECONDравно 250.
        См. также: значение константного поля
      • ZONE_OFFSET

        public static final int ZONE_OFFSET
        get和setномер поля обозначает исходное смещение GMT в миллисекундах. Если

        TimeZoneреализующий подкласс поддерживает исторические изменения смещения GMT, это поле отражает корректное значение смещения GMTCalendarдля часового пояса.

        См. также: значение константного поля
      • DST_OFFSET

        public static final int DST_OFFSET
        get和setномер поля обозначает смещение летнего времени в миллисекундах. Если

        TimeZoneЕсли подкласс поддерживает исторические изменения расписания летнего времени, это поле отражаетCalendarкорректное значение смещения летнего времени для этого часового пояса.

        См. также: значения констант полей
      • FIELD_COUNT

        public static final int FIELD_COUNT
        get和setЧисло различных распознаваемых полей. Диапазон номеров полей0..FIELD_COUNT-1 。
        См. также: значения констант полей
      • SUNDAY

        public static final int SUNDAY
        Значение поляDAY_OF_WEEK字段的值。
        См. также: значения констант полей
      • MONDAY

        public static final int MONDAY
        DAY_OF_WEEKЗначение поля обозначает понедельник.
        См. также: значения констант полей
      • TUESDAY

        public static final int TUESDAY
        Значение поляDAY_OF_WEEK字段的值。
        См. также: значения констант полей
      • WEDNESDAY

        public static final int WEDNESDAY
        DAY_OF_WEEKЗначение поля обозначает среду.
        См. также: значения констант полей
      • THURSDAY

        public static final int THURSDAY
        DAY_OF_WEEKЗначение поля обозначает четверг.
        См. также: значения констант полей
      • FRIDAY

        public static final int FRIDAY
        Значение поляDAY_OF_WEEK字段的值。
        См. также: значения констант полей
      • SATURDAY

        public static final int SATURDAY
        Значение поляDAY_OF_WEEK字段的值。
        См. также: значения констант полей
      • JANUARY

        public static final int JANUARY
        MONTHЗначение поля, обозначающее первый месяц года в григорианском и юлианском календарях.
        См. также: значения констант полей
      • FEBRUARY

        public static final int FEBRUARY
        MONTHЗначение поля, обозначающее второй месяц года в григорианском и юлианском календарях.
        См. также: значения констант полей
      • MARCH

        public static final int MARCH
        MONTHЗначение поля, обозначающее третий месяц года в григорианском и юлианском календарях.
        См. также: значения константных полей
      • APRIL

        public static final int APRIL
        MONTHЗначение поля, обозначающее четвёртый месяц года в григорианском и юлианском календарях.
        См. также: значения константных полей
      • MAY

        public static final int MAY
        MONTHЗначение поля, обозначающее пятый месяц года в григорианском и юлианском календарях.
        См. также: значения константных полей
      • JUNE

        public static final int JUNE
        MONTHЗначение поля, обозначающее шестой месяц года в григорианском и юлианском календарях.
        См. также: значения константных полей
      • JULY

        public static final int JULY
        MONTHЗначение поля, обозначающее седьмой месяц года в григорианском и юлианском календарях.
        См. также: значения константных полей
      • AUGUST

        public static final int AUGUST
        MONTHЗначение поля, обозначающее восьмой месяц года в григорианском и юлианском календарях.
        См. также: значения константных полей
      • SEPTEMBER

        public static final int SEPTEMBER
        MONTHЗначение поля, обозначающее девятый месяц года в григорианском и юлианском календарях.
        См. также: значения константных полей
      • OCTOBER

        public static final int OCTOBER
        MONTHЗначение поля, обозначающее десятый месяц года в григорианском и юлианском календарях.
        См. также: значения константных полей
      • NOVEMBER

        public static final int NOVEMBER
        MONTHЗначение поля, обозначающее одиннадцатый месяц года в григорианском и юлианском календарях.
        См. также: значения константных полей
      • DECEMBER

        public static final int DECEMBER
        MONTHЗначение поля, обозначающее двенадцатый месяц года в григорианском и юлианском календарях.
        См. также: значения константных полей
      • UNDECIMBER

        public static final int UNDECIMBER
        MONTHЗначение поля, обозначающее тринадцатый месяц года. ХотяGregorianCalendarэто значение не используется, лунный календарь его применяет.
        См. также: значения константных полей
      • AM

        public static final int AM
        AM_PMЗначение поля, обозначающее период дня от полуночи до полудня.
        См. также: значения константных полей
      • PM

        public static final int PM
        AM_PMЗначение поля, обозначающее период дня от полудня до полуночи.
        См. также: значения константных полей
      • 字段

        protected int[] fields
        Значения полей календаря для текущего установленного времени этого календаря. ЭтоFIELD_COUNTцелочисленный массив с индексами отERA到DST_OFFSET 。
      • isSet

        protected boolean[] isSet
        Флаг, указывающий, установлено ли указанное поле календаря. Новый объект не имеет установленных полей. После первого вызова метода, вычисляющего поля, все они остаются установленными. Это массивFIELD_COUNTлогических значений с индексами отERA到DST_OFFSET 。
      • time

        protected long time
        Текущее установленное время этого календаря в миллисекундах после 0:00:00 1 января 1970 года по гринвичскому времени.
        См. также:
        isTimeSet
      • isTimeSet

        protected boolean isTimeSet
        Если это так, тоtimeимеет допустимое значениеtimeИстина. Путём изменения проектаfield[]делает время недействительным.
        См. также:
        time
      • areFieldsSet

        protected boolean areFieldsSet
        Еслиfields[]синхронизировано с текущим установленным временем, fields[]значение True. Если значение false, следующая попытка получить значение поля вызовет пересчёт текущих значенийtimeвсех полей.
    • 构造方法详细信息

      • Calendar

        protected Calendar()
        Создаёт календарь с часовым поясом по умолчанию иFORMATязыковым стандартом по умолчанию.
        См. также:
        TimeZone.getDefault()
      • Calendar

        protected Calendar​(TimeZone zone,
                           Locale aLocale)
        Создаёт календарь с указанным часовым поясом и языковым стандартом.
        Параметры
        zone- используемый часовой пояс
        aLocale- языковой стандарт для данных недели
    • 方法详细信息

      • getInstance

        public static Calendar getInstance()
        Получает календарь с часовым поясом и языковым стандартом по умолчанию. ВозвращаемыйCalendarкалендарь основан на текущем времени в часовом поясе по умолчанию иFORMATязыковом стандарте по умолчанию. Если языковой стандарт содержит часовой пояс в Unicode extension «tz», используется этот часовой пояс.

        Результат: календарь.
      • getInstance

        public static Calendar getInstance​(TimeZone zone)
        Получает календарь с указанным часовым поясом и языковым стандартом по умолчанию. ВозвращаемыйCalendarкалендарь основан на текущем времени в данном часовом поясе и имеетFORMATязыковой стандарт по умолчанию.
        Параметры
        zone- используемый часовой пояс. Результат: календарь.
      • getInstance

        public static Calendar getInstance​(Locale aLocale)
        Получает календарь с часовым поясом по умолчанию и указанным языковым стандартом. ВозвращаемыйCalendarкалендарь основан на текущем времени в часовом поясе по умолчанию с данным языковым стандартом. Если языковой стандарт содержит часовой пояс в Unicode extension «tz», используется этот часовой пояс.

        Параметры
        aLocale- языковой стандарт для данных недели. Результат: календарь.
      • getInstance

        public static Calendar getInstance​(TimeZone zone,
                                           Locale aLocale)
        Получает календарь с указанным часовым поясом и языковым стандартом. ВозвращаемыйCalendarкалендарь основан на текущем времени в данном часовом поясе с данным языковым стандартом.
        Параметры
        zone- используемый часовой пояс
        aLocale- Локаль для недельных данных. Результат: календарь.
      • getAvailableLocales

        public static Locale[] getAvailableLocales()
        ВозвращаетgetInstanceМетод возвращает массив всех локалей, для которых есть локализованные экземпляры. Возвращаемый массив содержит минимум один элемент, равныйLocale.US的Locale.
        Результат: набор локалей, для которых доступны локализованные
        Calendarэкземпляры.
      • computeFields

        protected abstract void computeFields()
        Преобразует текущее значение времени в миллисекундах вtimeзначения полей календаряfields[]. Это позволяет синхронизировать значения полей календаря с новым временем, установленным для календаря. Время сначала не пересчитывается. Чтобы пересчитать время, а затем поля, вызовите методcomplete().
        Смотрите также:
        computeTime()
      • getTime

        public final Date getTime()
        Возвращает объектCalendarсо значением времени (смещение в миллисекундах от Epoch) для этогоDate对象。
        Результат
        Dateпредставляет значение времени. См. также:
        setTime(Date),getTimeInMillis()
      • setTime

        public final void setTime​(Date date)
        Устанавливает время этого календаря по заданномуDateзначению. Примечание: при использовании

        Date(Long.MAX_VALUE)或Date(Long.MIN_VALUE)调用setTime()может получитьget()некорректные значения полей.

        Параметр
        date- заданная дата. Смотрите также:
        getTime(),setTimeInMillis(long)
      • getTimeInMillis

        public long getTimeInMillis()
        возвращает значение времени этого Calendar в миллисекундах.
        Результат Текущее время в миллисекундах UTC от начала эпохи. Смотрите также:
        getTime(),setTimeInMillis(long)
      • setTimeInMillis

        public void setTimeInMillis​(long millis)
        Устанавливает текущее время этого Calendar из заданного значения long.
        Параметры
        millis- Новое время в миллисекундах UTC от начала эпохи. См. также:
        setTime(Date),getTimeInMillis()
      • get

        public int get​(int field)
        Возвращает значение заданного поля календаря. В мягком режиме все поля календаря нормализуются. В строгом режиме все поля календаря проверяются. Если какое-либо поле выходит за допустимый диапазон, метод выбрасывает исключение. Нормализацию и проверку выполняетcomplete()метод, который зависит от календарной системы.
        Параметры
        字段- Заданное поле календаря. Результат: значение заданного поля календаря. Исключения
        ArrayIndexOutOfBoundsException - Если указанное поле выходит за допустимый диапазон ( field < 0 || field >= FIELD_COUNT). См. также:
        set(int,int),complete()
      • internalGet

        protected final int internalGet​(int field)
        Возвращает значение заданного поля календаря. Этот метод не выполняет нормализацию или проверку значения поля.
        Параметры
        字段- Заданное поле календаря. Результат: значение заданного поля календаря. См. также:
        get(int)
      • set

        public void set​(int field,
                        int value)
        Устанавливает заданное поле календаря в заданное значение. Этот метод не интерпретирует значение независимо от режима.
        Параметры
        字段- Заданное поле календаря.
        value- Значение, которое нужно установить для заданного поля календаря. Исключения
        ArrayIndexOutOfBoundsException - Если указанное поле выходит за допустимый диапазон ( field < 0 || field >= FIELD_COUNT). В строгом режиме. См. также:
        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)
        Устанавливает значения полей календаряYEAR , MONTH和DAY_OF_MONTH. Предыдущие значения других полей календаря сохраняются. Если это не нужно, сначала вызовитеclear().
        Параметры
        year - 用于设置 YEAR.
        month - 用于设置MONTH. Значения месяцев начинаются с 0. Например, 0 означает январь.
        date - 用于设置 DAY_OF_MONTHЗначение поля календаря. Смотрите также:
        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)
        Устанавливает значение поля календаряYEAR , MONTH , DAY_OF_MONTH , HOUR_OF_DAY和MINUTE. Предыдущие значения других полей сохраняются. Если это не нужно, сначала вызовитеclear().
        Параметры
        year - 用于设置 YEARполя календаря.
        month - 用于设置MONTHполя календаря. Номер месяца начинается с 0. Например, 0 означает январь.
        date - 用于设置 DAY_OF_MONTHполя календаря.
        hourOfDay - 用于设置 HOUR_OF_DAYполя календаря.
        minute - 用于设置 MINUTEполя календаря. Смотрите также:
        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)
        Устанавливает значение в полеYEAR , MONTH , DAY_OF_MONTH , HOUR_OF_DAY , MINUTE和SECOND. Предыдущие значения других полей сохраняются. Если это не нужно, сначала вызовитеclear().
        Параметры
        year - 用于设置 YEARполя календаря.
        month - 用于设置MONTHполя календаря. Номер месяца начинается с 0. Например, 0 означает январь.
        date - 用于设置 DAY_OF_MONTHполя календаря.
        hourOfDay - 用于设置 HOUR_OF_DAYЗначение поля календаря.
        minute - 用于设置 MINUTEЗначение поля календаря.
        second - 用于设置 SECONDЗначение поля календаря. См. также:
        set(int,int),set(int,int,int),set(int,int,int,int,int)
      • clear

        public final void clear()
        Настройте этоCalendarВсе неопределённые значения полей календаря и значения времени (смещение в миллисекундах от Epoch). Это означаетisSet()Будет возвращено для всех полей календаря.falseПри вычислении даты и времени поле считается никогда не установленным.CalendarКлассы реализации могут использовать свои собственные значения полей по умолчанию для вычислений даты и времени. Например, еслиYEARЕсли значение поля не определено, тоGregorianCalendarИспользуйте 1970.
        См. также:
        clear(int)
      • clear

        public final void clear​(int field)
        Настройте этот параметр.CalendarЗначения заданных полей календаря для undefined и значение времени (смещение в миллисекундах от Epoch). Это означаетisSet(field)будет возвращеноfalseи вычисления даты и времени будут считать это поле никогда не установленным.CalendarКлассы реализации могут выполнять вычисления даты и времени с определёнными значениями полей по умолчанию.

        HOUR_OF_DAY,HOURиAM_PMПоля обрабатываются независимо, и применяется the resolution rule for the time of day. Очистка одного из полей не сбрасывает это.Calendarзначения за час. Использованиеset(Calendar.HOUR_OF_DAY, 0)Сброс значения часов.

        Параметры
        字段- Очищаемые поля календаря. См. также:
        clear()
      • isSet

        public final boolean isSet​(int field)
        Определяет, имеет ли заданное поле календаря набор значений, включая установленное значение.getСлучай, когда вызов метода инициирует вычисление и установку значения внутреннего поля.
        Параметры
        字段- Календарное поле для теста Результат
        trueесли заданное поле календаря имеет набор значений, в противном случае falsefalse。
      • getDisplayName

        public String getDisplayName​(int field,
                                     int style,
                                     Locale locale)
        Возвращает заданныйstyle和locale日历字段Строковое представление значенияlocale. Если применимого строкового представления нет, возвращаетnull. Если строковое представление применимо к заданному календарю字段, то этот метод вызываетget(field), чтобы получить значение календаря字段. Например, если этот

        Calendar是GregorianCalendarи его дата — 2005-01-01, тоMONTHстроковое представление поля будет «января» в длинном стиле или «янв.» в коротком стиле для английской локали. НоDAY_OF_MONTHЕсли у поля нет доступного строкового представления, этот метод вернётnull 。

        Реализация по умолчанию поддерживает календарные поляDateFormatSymbolsс заданными именамиlocale 。

        Параметры
        字段- календарное поле, для которого возвращается строковое представление
        style- стиль, применяемый к строковому представлению; одно из значенийSHORT_FORMAT(SHORT),SHORT_STANDALONE,LONG_FORMAT(LONG),LONG_STANDALONE,NARROW_FORMAT, илиNARROW_STANDALONE。
        locale - строковое представление локали (любой тип календаря, указанный в localeбудет проигнорирован) Результат Заданное
        字段в заданном style字符串表示 style , если нет подходящего строкового представления style , null。 Исключение
        IllegalArgumentException - 如果 字段或 style无效,或者此 CalendarСтрогий режим и любое поле календаря имеет недопустимое значение
        NullPointerException - 如果 localeПусто. Начиная с версии: 1.6
      • getDisplayNames

        public Map<String,​Integer> getDisplayNames​(int field,
                                                         int style,
                                                         Locale locale)
        ВозвращаетMapобъект, содержащий все имена для заданныхstyle和locale日历字段полей и соответствующие им значения полей. Например, если этотCalendarравенGregorianCalendar, то возвращаемый объект будет содержать "Jan" дляJANUARY, "Feb" дляFEBRUARYи так далее в стиле short для английской локали. Из-за использования одного символа узкие имена могут быть неуникальными, например "S" для воскресенья и субботы. В этом случае узкие имена не включаются в возвращаемый

        Map 。

        Для определения набора отображаемых имен учитываются значения других полей календаря. Например, если этотCalendarпредставляет лунно-солнечную календарную систему и значение года в полеYEARсодержит високосный месяц, метод вернет названия месяцев, включая високосный месяц. Названия месяцев будут сопоставлены с названиями, зависящими от конкретного года.

        Реализация по умолчанию поддерживает отображаемые имена, содержащиеся вDateFormatSymbols. Например, если字段равенMONTHиstyleравенALL_STYLES, этот метод возвращаетMap, содержащий все строки, возвращаемыеDateFormatSymbols.getShortMonths()иDateFormatSymbols.getMonths().

        Параметры
        字段- поле календаря, для которого возвращаются отображаемые имена
        style- стиль, применяемый к строковым представлениям; одно из значенийSHORT_FORMAT(SHORT),SHORT_STANDALONE,LONG_FORMAT(LONG),LONG_STANDALONE,NARROW_FORMATилиNARROW_STANDALONE
        locale- локаль для отображаемых имен Результат Объект
        Map, содержащий все отображаемые имена style和 localeи их значения полей, или null, если отображаемые имена не определены для 字段
        Исключения
        IllegalArgumentException - 如果 字段或 style无效,或者此 Calendarне допускает отклонений и любое поле календаря имеет недопустимое значение
        NullPointerException - 如果 localeравно null. Начиная с версии: 1.6
      • complete

        protected void complete()
        заполняет все незаполненные поля календаря. Сначала, если значение времени (смещение в миллисекундах от Epoch) ещё не вычислено по полям календаря, вызываетсяcomputeTime()метод. Затем вызываетсяcomputeFields()метод для вычисления значений всех полей календаря.
      • getAvailableCalendarTypes

        public static Set<String> getAvailableCalendarTypes()
        возвращает неизменяемыйSetкоторый содержит все типы календарей, поддерживаемыеCalendarв среде выполнения. Доступные типы календарей можно использовать в Unicode locale extensions. ВозвращаемыйSetсодержит как минимум"gregory". Типы календарей не содержат псевдонимов, например"gregorian" ( "gregory" 。
        Результат: неизменяемый
        Set
        со всеми доступными типами календарей. Начиная с версии: 1.8 См. также:
        getCalendarType(),Calendar.Builder.setCalendarType(String),Locale.getUnicodeLocaleType(String)
      • getCalendarType

        public String getCalendarType()
        возвращает тип календаря этогоCalendar. Тип календаря определяется спецификацией Unicode locale data markup language (LDML). Реализация по умолчанию возвращает имя класса этого

        Calendarэкземпляра. Любой подкласс, реализующий календарную систему, определённую в LDML, должен переопределить этот метод и вернуть соответствующий тип календаря.

        Результат: тип календаря, определённый в LDML, или имя класса этого
        Calendarэкземпляра. Начиная с версии: 1.8 См. также: Locale extensions,
        Locale.Builder.setLocale(Locale),Locale.Builder.setUnicodeLocaleKeyword(String, String)
      • equals

        public boolean equals​(Object obj)
        сравнивает этотCalendarс указаннымObject. Результат равенCalendarтолько тогда, когда аргумент являетсяtrue объектом той же календарной системы, который представляет то же значение времени (смещение в миллисекундах от Epoch) при тех жеCalendarпараметрах. Параметры

        Calendarзадаются значениями, которые возвращают методыisLenient , getFirstDayOfWeek , getMinimalDaysInFirstWeek和getTimeZone. Если между двумяCalendarесть любое различие в параметрах, этот метод возвращаетfalse 。

        ИспользуйтеcompareToметод, он сравнивает только значения времени.

        Переопределяет:
        equals类 Object
        Параметры
        obj- объект для сравнения. Результат
        truetrue, если этот объект равенobj; иначеfalse. См. также:
        Object.hashCode(),HashMap
      • before

        public boolean before​(Object when)
        Возвращает, обозначает ли этотCalendar是否表示指定的Object. Этот метод эквивалентен следующему:
           compareTo(when) < 0  
        当且仅当when是Calendar. Иначе метод возвращаетfalse 。
        Параметры
        when - 待比较的 Object
        для сравнения. Результат
        truetrue, если время, которое задаёт этотCalendar, раньше времени, заданногоwhen; иначеfalse. См. также:
        compareTo(Calendar)
      • after

        public boolean after​(Object when)
        Возвращает, обозначает ли этотCalendar是否表示指定的Object. Этот метод эквивалентен следующему:
           compareTo(when) > 0  
        当且仅当when是Calendar. Иначе метод возвращаетfalse 。
        Параметры
        when - 待比较的 Object
        Результат
        true如果此Calendar的时间when于whenпредставляет указанный объект; иначе false. См. также:falsecompareTo
        compareTo(Calendar)
      • compareTo

        public int compareTo​(Calendar anotherCalendar)
        Сравнивает значения времени, которые представляют дваCalendarобъекта (смещение в миллисекундах от начала Epoch).
        Определено в:
        compareTo в интерфейсе Comparable<Calendar>
        Параметры
        anotherCalendar - 待比较的 Calendar. Результат: значение
        00, если время, которое представляет параметр, равно времени этого объектаCalendar; значение меньшеCalendar0, если время этого объекта раньше времени параметра0; значение большеCalendar0, если время этого объекта позже времени параметра0. Исключения
        NullPointerException NullPointerException - если указанный Calendarобъект nullравен null.
        IllegalArgumentException - если значение времени указанного объекта нельзя получить из-за недопустимых значений календаря. Начиная с версии: 1.5 Calendaradd
      • add

        public abstract void add​(int field,
                                 int amount)
        add(Calendar.DATE, -5).

        add(Calendar.DAY_OF_MONTH, -5) 。

        - поле календаря.
        字段- количество дней или времени, которое нужно добавить в поле. См. также:
        amountroll,
        roll(int,int)rollset(int,int)
      • roll

        public abstract void roll​(int field,
                                  boolean up)
        getMaximum(Calendar.YEAR).

        getMaximum(Calendar.YEAR)При прокрутке поля месяца или Calendar.MONTH могут конфликтовать другие поля, например день месяца, и их нужно изменить. Например, прокрутка месяца для даты 01/31/96 даст 02/29/96. При прокрутке поля часа или Calendar.HOUR_OF_DAY значение часа прокручивается в диапазоне от 0 до 23, начиная с нуля.

        Параметры
        字段- поле времени.
        up- указывает, нужно ли увеличивать или уменьшать значение указанного поля времени. Используйте true для увеличения, иначе false. См. также:
        add(int,int),set(int,int)
      • roll

        public void roll​(int field,
                         int amount)
        Добавляет указанное (со знаком) значение к указанному полю календаря, не изменяя более крупные поля. Отрицательное число означает прокрутку назад. Примечание:

        Calendarэта реализация по умолчанию просто повторно вызывает версию с прокруткой на одну единицуroll(). Это не всегда даёт правильный результат. Например, еслиDAY_OF_MONTHполе равно 31, прокрутка до февраля установит его в 28. Версия этой функцииGregorianCalendarможет решить эту проблему. Другие подклассы также должны переопределять эту функцию, чтобы делать правильные действия.

        Параметры
        字段- поле календаря.
        amount - значение со знаком, которое нужно добавить к полю календаря 字段. Начиная с версии: 1.2 См. также:
        roll(int,boolean),add(int,int),set(int,int)
      • setTimeZone

        public void setTimeZone​(TimeZone value)
        Устанавливает часовой пояс с заданным значением часового пояса.
        Параметры
        value- заданный часовой пояс.
      • getTimeZone

        public TimeZone getTimeZone()
        Получает часовой пояс.
        Результат: объект часового пояса, связанный с этим календарём.
      • setLenient

        public void setLenient​(boolean lenient)
        Указывает, является ли интерпретация даты/времени мягкой. При мягкой интерпретации дата вроде «942 февраля 1996 года» считается равной 941-му дню после 1 февраля 1996 года. При строгой (немягкой) интерпретации такая дата вызывает исключение. По умолчанию режим мягкий.
        Параметры
        lenient - truetrue, если нужно включить мягкий режим;falsefalse, если нужно выключить. См. также:
        isLenient(),DateFormat.setLenient(boolean)
      • isLenient

        public boolean isLenient()
        Сообщает, является ли интерпретация даты/времени мягкой.
        Результат
        truetrue, если режим интерпретации этого календаря мягкий; иначеfalsefalse. См. также:
        setLenient(boolean)
      • setFirstDayOfWeek

        public void setFirstDayOfWeek​(int value)
        Устанавливает, какой день является первым днём недели; например,SUNDAY在美国, MONDAY在法国。
        Параметры
        value- первый день недели. См. также:
        getFirstDayOfWeek(),getMinimalDaysInFirstWeek()
      • getFirstDayOfWeek

        public int getFirstDayOfWeek()
        Возвращает первый день недели; например,SUNDAY在美国, MONDAY在法国。
        Результат — первый день недели. См. также:
        setFirstDayOfWeek(int),getMinimalDaysInFirstWeek()
      • setMinimalDaysInFirstWeek

        public void setMinimalDaysInFirstWeek​(int value)
        Задаёт минимальное число дней, необходимое для первой недели года. Например, если первая неделя определена как неделя, содержащая первый день первого месяца года, вызовите этот метод со значением 1. Если требуется полная неделя, используйте значение 7.
        Параметры
        value— минимальное число дней, необходимое для первой недели года. См. также:
        getMinimalDaysInFirstWeek()
      • getMinimalDaysInFirstWeek

        public int getMinimalDaysInFirstWeek()
        Возвращает минимальное число дней, необходимое для первой недели года. Например, если первая неделя определена как неделя, содержащая первый день первого месяца года, этот метод возвращает 1. Если требуется полная неделя, этот метод возвращает 7.
        Результат — минимальное число дней, необходимое для первой недели года. См. также:
        setMinimalDaysInFirstWeek(int)
      • isWeekDateSupported

        public boolean isWeekDateSupported()
        Возвращает, поддерживает ли этотCalendarнедельные даты. Реализация этого метода по умолчанию возвращает

        false 。

        Результат
        true— если этотCalendarподдерживает недельные даты; иначеfalse. Начиная с версии: 1.7 См. также:
        getWeekYear(),setWeekDate(int,int,int),getWeeksInWeekYear()
      • getWeekYear

        public int getWeekYear()
        ВозвращаетCalendar表示的Calendar. Год недели синхронизирован с недельным циклом. first day of the first week — это первый день недели. Реализация этого метода по умолчанию выбрасывает

        UnsupportedOperationException.

        Результат — этот
        Calendarэтого Calendar
        Исключения
        UnsupportedOperationException - 如果此 Calendarне поддерживает нумерацию недельных годов. Начиная с версии: 1.7 См. также:
        isWeekDateSupported(),getFirstDayOfWeek(),getMinimalDaysInFirstWeek()
      • setWeekDate

        public void setWeekDate​(int weekYear,
                                int weekOfYear,
                                int dayOfWeek)
        Устанавливает дату этогоCalendarпо заданным спецификаторам — год недели, неделя и день недели. В отличие от метода

        setвсе поля календаря и значенияtimeвычисляются при возврате.

        ЕслиweekOfYearВ пределах года за пределами действующей неделиweekYear , данныйweekYear个weekOfYearЗначение настраивается в свободном режиме, илиIllegalArgumentExceptionВызывается в нестрогом режиме.

        Реализация этого метода по умолчанию выбрасывает исключение.UnsupportedOperationException 。

        Параметры
        weekYearНеделя года
        weekOfYear - Количество недель за текущую неделю рассчитано на основе weekYear
        dayOfWeek- Значение недели:DAY_OF_WEEKОдна из констант поля:SUNDAY,...,SATURDAYИсключение
        IllegalArgumentException- если любой из заданных описателей даты недействителен или любое поле календаря не соответствует заданным описателям даты в режиме non-lenient
        UnsupportedOperationException - 如果此 CalendarАннотации годовщины не поддерживаются. Начиная с версии: 1.7. См. также:
        isWeekDateSupported(),getFirstDayOfWeek(),getMinimalDaysInFirstWeek()
      • getWeeksInWeekYear

        public int getWeeksInWeekYear()
        Возвращает этоCalendarНеделя в указанном годуCalendarРеализация этого метода по умолчанию выбрасывает исключение.

        UnsupportedOperationException 。

        Результат: номер недели в году. Исключения
        UnsupportedOperationException - 如果此 CalendarНе поддерживаются никакие юбилейные номера.
        WEEK_OF_YEAR,isWeekDateSupported(),getWeekYear(),getActualMaximum(int)
      • getMinimum

        public abstract int getMinimum​(int field)
        Возвращает этоCalendar实例的给定日历字段的CalendarМинимальное значение определяется какgetМинимальное значение, которое метод возвращает для любого возможного значения времени. Минимальное значение зависит от конкретных параметров календарной системы экземпляра.
        Параметры
        字段- Поле календаря. Результат: минимальное значение заданного поля календаря. См. также:
        getMaximum(int),getGreatestMinimum(int),getLeastMaximum(int),getActualMinimum(int),getActualMaximum(int)
      • getMaximum

        public abstract int getMaximum​(int field)
        возвращает максимальное значениеCalendar实例的给定日历字段的Calendarэкземпляра. Максимальное значение определяется какgetнаибольшее значение, которое метод возвращает для любого возможного значения времени. Максимальное значение зависит от конкретных параметров календарной системы экземпляра.
        Параметры
        字段- поле календаря. Результат Максимальное значение указанного поля календаря. См. также:
        getMinimum(int),getGreatestMinimum(int),getLeastMaximum(int),getActualMinimum(int),getActualMaximum(int)
      • getGreatestMinimum

        public abstract int getGreatestMinimum​(int field)
        возвращает наибольшее минимальное значениеCalendarуказанного поля календаря для этого экземпляра. Наибольшее минимальное значение определяется какgetActualMinimum(int)наибольшее значение, которое метод возвращает для любого возможного значения времени. Наибольшее минимальное значение зависит от конкретных параметров календарной системы экземпляра.
        Параметры
        字段- поле календаря. Результат Наибольшее минимальное значение указанного поля календаря. См. также:
        getMinimum(int),getMaximum(int),getLeastMaximum(int),getActualMinimum(int),getActualMaximum(int)
      • getLeastMaximum

        public abstract int getLeastMaximum​(int field)
        возвращает наименьшее максимальное значениеCalendarуказанного поля календаря для этого экземпляра. Наименьшее максимальное значение определяется какgetActualMaximum(int)наименьшее значение, которое метод возвращает для любого возможного значения времени. Наименьшее максимальное значение зависит от конкретных параметров календарной системы экземпляра. Например,Calendarдля григорианской календарной системы метод возвращает 28 DAY_OF_MONTHдля поля дня месяца, потому что 28-е число является последним днём февраля, самого короткого месяца в невисокосном году этого календаря.
        Параметры
        字段- поле календаря. Результат Наименьшее максимальное значение указанного поля календаря. См. также:
        getMinimum(int),getMaximum(int),getGreatestMinimum(int),getActualMinimum(int),getActualMaximum(int)
      • getActualMinimum

        public int getActualMinimum​(int field)
        Для заданного значения времени этогоCalendarвозвращает минимальное значение, которое может иметь указанное поле календаряCalendar. Реализация этого метода по умолчанию использует итеративный алгоритм для определения фактического минимального значения поля календаря. Подклассы должны переопределять его более эффективной реализацией, если это возможно. Во многих случаях они могут просто вернуть

        getMinimum() 。

        Параметры
        字段- поле календаря Результат значение этого
        Calendarполя календаря для данного значения времени Calendar
        Начиная с версии: 1.2 См. также:
        getMinimum(int),getMaximum(int),getGreatestMinimum(int),getLeastMaximum(int),getActualMaximum(int)
      • getActualMaximum

        public int getActualMaximum​(int field)
        Для данного значения времени этогоCalendarобъекта возвращает максимальное возможное значение указанного поля календаря. Например,Calendar 。 例如, MONTH字段的实际最大值在某些年份为12,在希伯来日历系统中为其他年份的13。

        此方法的默认实现使用迭代算法来确定日历字段的实际最大值。 如果可能,子类应该使用更有效的实现来覆盖它。

        Параметры
        字段- поле календаря Результат значение этого
        Calendarполя календаря для данного значения времени Calendar
        Начиная с версии: 1.2 См. также:
        getMinimum(int),getMaximum(int),getGreatestMinimum(int),getLeastMaximum(int),getActualMinimum(int)
      • clone

        public Object clone()
        Создаёт и возвращает копию этого объекта.
        Переопределяет:
        cloneв классе Object
        Результат копия этого объекта. См. также:
        Cloneable
      • toString

        public String toString()
        Возвращает строковое представление этого календаря. Этот метод предназначен только для отладки, формат строки зависит от реализации. Возвращаемая строка может быть пустой, но не может бытьnull 。
        Переопределяет:
        toStringв классе Object
        Результат строковое представление этого календаря.
      • toInstant

        public final Instant toInstant()
        Преобразует этот объект вInstant. Преобразование создаёт

        Instant объект, представляющий ту же точку на временной шкале, что и этотCalendarобъект.

        Результат момент времени, представляющий ту же точку на временной шкале. Начиная с версии: 1.8