- java.lang.Object
- java.util.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Значения полей календаря разбираются для определения даты и времени следующим образом. Если значения полей календаря конфликтуют,
Для полей времени суток: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и так далее.Примечание. Существуют возможные неоднозначности при интерпретации некоторых особых времён. Они разрешаются следующим образом:
- 23:59 — последняя минута дня, 00:00 — первая минута следующего дня. Поэтому 31 декабря 1999 года 23:59 < 1 января 2000 года 00:00 < 1 января 2000 года 00:01.
- Хотя исторически это неточно, полночь относится к «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 field
fafter the call minus the value of fieldfbefore the call isdelta, modulo any overflow that has occurred in fieldfПереполнение возникает, когда значение поля выходит за пределы своего диапазона. В этом случае следующее большее поле увеличивается или уменьшается. Значение поля корректируется обратно в свой диапазон.Добавьте правило 2. Пусть меньшее поле должно быть инвариантным. Но оно не может равняться прежнему значению. Причина — изменение минимума или максимума поля.
fis changed or other constraints, such as time zone offset changes, then its value is adjusted to be as close as possible to its expected value. A smaller field represents a smaller unit of time.HOURis a smaller field thanDAY_OF_MONTH. No adjustment is made to smaller fields that are not expected to be invariant. The calendar system determines what fields are expected to be invariant.Кроме того, в отличие от
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 classCalendar.BuilderCalendar.BuilderИспользуется для созданияCalendar。
-
字段汇总
Поле Переменные и типы Описание поля static intALL_STYLESgetDisplayNamesСпецификатор стиля дляstatic intAMAM_PM, указывающий длинные имена во всех стилях, например «January» и «Jan».static intAM_PMget和set, обозначающее период дня от полуночи до полудня.HOURиstatic intAPRILMONTH— номера полей, указывающие, находится лиprotected booleanareFieldsSetдо или после полудня.fields[]Значение поляfields[], обозначающее четвертый месяц года в григорианском и юлианском календарях.static intAUGUSTMONTHTruestatic intDATEget和setсинхронизирован с текущим установленным временем.static intDAY_OF_MONTHget和set, обозначающее восьмой месяц года в григорианском и юлианском календарях.static intDAY_OF_WEEKиget和setОбозначает день недели.static intDAY_OF_WEEK_IN_MONTHget和setНомер поля, обозначающий порядковый номер дня в текущем месяце.static intDAY_OF_YEARget和setНомер поля обозначает порядковый номер дня в текущем году.static intDECEMBERMONTHЗначение поля обозначает двенадцатый месяц года в григорианском и юлианском календарях.static intDST_OFFSETget和setНомер поля, указывающий смещение летнего времени в миллисекундах.static intERAget和setНомер поля обозначает эпоху, например AD или BC в юлианском календаре.static intFEBRUARYMONTHЗначение поля, обозначающее второй месяц года в григорианском и юлианском календарях.static intFIELD_COUNTget和setКоличество распознанных полей.protected int[]字段Значения полей календаря для текущего установленного времени этого календаря.static intFRIDAYDAY_OF_WEEKЗначение поля обозначает пятницу.static intHOURget和setНомер поля обозначает час до или после полудня.static intHOUR_OF_DAYget和setНомер поля обозначает час текущего дня.protected boolean[]isSetФлаг, показывающий, установлено ли указанное поле календаря.protected booleanisTimeSetесли... тоtimeзначение действительноtimeИстина.static intJANUARYMONTHЗначение поля обозначает первый месяц года в григорианском и юлианском календарях.static intJULYMONTHЗначение поля, обозначающее седьмой месяц года в григорианском и юлианском календарях.static intJUNEMONTHЗначение поля обозначает шестой месяц в григорианском и юлианском календарях.static intLONGstatic intLONG_FORMATstatic intLONG_STANDALONEstatic intMARCHMONTHЗначение поля, обозначающее третий месяц года в григорианском и юлианском календарях.static intMAYMONTHЗначение поля, обозначающее пятый месяц года в григорианском и юлианском календарях.static intMILLISECONDget和setНомер поля обозначает количество миллисекунд в секунде.static intMINUTEget和setНомер поля обозначает минуты в пределах часа.static intMONDAYDAY_OF_WEEKЗначение поля означает понедельник.static intMONTHget和setНомер поля обозначает месяц.static intNARROW_FORMATstatic intNARROW_STANDALONEstatic intNOVEMBERMONTHЗначение поля, обозначающее одиннадцатый месяц в григорианском и юлианском календарях.static intOCTOBERMONTHЗначение поля, обозначающее десятый месяц в григорианском и юлианском календарях.static intPMAM_PMЗначение поля, обозначающее период дня от полудня до полуночи.static intSATURDAYЗначение поляDAY_OF_WEEK字段的值。static intSECONDget和setНомер поля обозначает секунду в пределах минуты.static intSEPTEMBERMONTHЗначение поля, обозначающее девятый месяц в григорианском и юлианском календарях.static intSHORTstatic intSHORT_FORMATstatic intSHORT_STANDALONEstatic intSUNDAYЗначение поляDAY_OF_WEEK字段的值。static intTHURSDAYDAY_OF_WEEKЗначение поля обозначает четверг.protected longtimeТекущее установленное время этого календаря в миллисекундах после 0:00:00 1 января 1970 года по Гринвичу.static intTUESDAYЗначение поляDAY_OF_WEEK字段的值。static intUNDECIMBERMONTHЗначение поля, обозначающее тринадцатый месяц года.static intWEDNESDAYDAY_OF_WEEKЗначение поля обозначает среду.static intWEEK_OF_MONTHget和setНомер поляgetset的周数。static intWEEK_OF_YEARget和setНомер поля обозначает номер недели в текущем году.static intYEARНомер поля равенget和setобозначает год.static intZONE_OFFSETget和setНомер поля, обозначающий исходное смещение относительно GMT в миллисекундах.
-
方法摘要
Все методы Статические методы Методы экземпляра Абстрактные методы Конкретные методы Переменные и типы Метод Описание abstract voidadd(int field, int amount)Метод добавляет или вычитает указанный интервал времени из заданного поля календаря по правилам календаря.booleanafter(Object when)Вернуться назадCalendar是否表示指定的ObjectВремя после указанного времени.booleanbefore(Object when)Возвращает значение этогоCalendar是否表示指定的Objectвременем, которое он представляет.voidclear()voidclear(int field)Objectclone()Создаёт и возвращает копию этого объекта.intcompareTo(Calendar anotherCalendar)protected voidcomplete()Заполните все незаданные поля в календаре.protected abstract voidcomputeFields()protected abstract voidcomputeTime()booleanequals(Object obj)Возьмите этотCalendarС указаннымObject。intget(int field)Возвращает значение заданного поля календаря.intgetActualMaximum(int field)Для данногоCalendarзначения времени возвращает максимальное значение, которое может иметь указанное поле календаряCalendar。intgetActualMinimum(int field)Для данногоCalendarзначения времени возвращает максимальное значение, которое может иметь указанное поле календаряCalendar。static Set<String>getAvailableCalendarTypes()Возвращает неизменяемыйSetобъект, который содержит все типы календарей, поддерживаемыеCalendarв среде выполнения.static Locale[]getAvailableLocales()Возвращает массив всех локалей,getInstanceметод можетgetInstanceвозвращать локализованный экземпляр.StringgetCalendarType()Возвращает тип календаряCalendarэтого объекта.StringgetDisplayName(int field, int style, Locale locale)Возвращает строковое представлениеstyle和locale日历字段в виде строкиlocale。Map<String,Integer>getDisplayNames(int field, int style, Locale locale)ВозвращаетMapкоторый содержит все имена заданногоstyle和locale日历字段и соответствующие им значения полей.intgetFirstDayOfWeek()Возвращает первый день недели, например,SUNDAY在美国,MONDAY在法国。abstract intgetGreatestMinimum(int field)Возвращает наибольшее минимальное значение заданного календарного поля этогоCalendarэкземпляра.static CalendargetInstance()Получает календарь с часовым поясом и региональными настройками по умолчанию.static CalendargetInstance(Locale aLocale)Получает календарь с часовым поясом по умолчанию и указанными региональными настройками.static CalendargetInstance(TimeZone zone)Получает календарь с указанным часовым поясом и региональными настройками по умолчанию.static CalendargetInstance(TimeZone zone, Locale aLocale)Получает календарь с указанным часовым поясом и региональными настройками.abstract intgetLeastMaximum(int field)Возвращает минимальное максимальное значениеCalendarзаданного поля календаря этого экземпляра.abstract intgetMaximum(int field)ВозвращаетCalendar实例的给定日历字段的Calendar。intgetMinimalDaysInFirstWeek()Получает минимальное количество дней, необходимое для первой недели года. Например, если первая неделя определена как неделя, содержащая первый день первого месяца года, метод возвращает 1.abstract intgetMinimum(int field)Возвращает значениеCalendar实例的给定日历字段的Calendar。DategetTime()longgetTimeInMillis()Возвращает значение времени этого Calendar в миллисекундах.TimeZonegetTimeZone()Получает часовой пояс.intgetWeeksInWeekYear()Возвращает неделю в неделе,Calendarпредставленную этимCalendar。intgetWeekYear()Возвращает этоCalendarобозначаетCalendar。inthashCode()Возвращает хеш-код этого календаря.protected intinternalGet(int field)Возвращает значение заданного поля календаря.booleanisLenient()Указывает, допускает ли интерпретация даты/времени отклонения.booleanisSet(int field)Определяет, имеет ли заданное поле календаря установленное значение, включаяgetСлучай, когда вызов метода запускает вычисление и установку значения внутреннего поля.booleanisWeekDateSupported()Возвращает этоCalendarПоддерживает ли дату недели.abstract voidroll(int field, boolean up)Добавляет или вычитает (вверх/вниз) одну единицу времени в заданном поле времени. Большие поля не изменяются.voidroll(int field, int amount)Добавляет указанную (со знаком) величину к указанному полю календаря. Большие поля не изменяются.voidset(int field, int value)Устанавливает заданное поле календаря в заданное значение.voidset(int year, int month, int date)Устанавливает значение полей календаряYEAR,MONTH和DAY_OF_MONTH。voidset(int year, int month, int date, int hourOfDay, int minute)Устанавливает значение поля календаряYEAR,MONTH,DAY_OF_MONTH,HOUR_OF_DAY和MINUTE。voidset(int year, int month, int date, int hourOfDay, int minute, int second)Установите значение в полеYEAR,MONTH,DAY_OF_MONTH,HOUR_OF_DAY,MINUTE和SECOND。voidsetFirstDayOfWeek(int value)Задаёт первый день недели. Например,SUNDAY在美国,MONDAY在法国。voidsetLenient(boolean lenient)Указывает, строго ли интерпретируется дата/время.voidsetMinimalDaysInFirstWeek(int value)Задаёт минимальное число дней в первой неделе года. Например, если первая неделя содержит первый день первого месяца года, вызовите этот метод со значением 1.voidsetTime(Date date)Использует заданныйDateустанавливает время этого календаря.voidsetTimeInMillis(long millis)Устанавливает текущее время этого Calendar из заданного значения long.voidsetTimeZone(TimeZone value)Устанавливает часовой пояс по заданному значению.voidsetWeekDate(int weekYear, int weekOfYear, int dayOfWeek)Устанавливает дату этогоCalendarобъекта с помощью заданного спецификатора даты: год, месяц и день недели.InstanttoInstant()Преобразует этот объект вInstant.StringtoString()Возвращает строковое представление этого календаря.
-
-
-
字段详细信息
-
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. Последний зависит от количества месяцев в году.
-
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。
-
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。
-
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Значение поля, обозначающее период дня от полудня до полуночи.
-
ALL_STYLES
public static final int ALL_STYLES
getDisplayNamesспецификатор стиля, обозначающий все названия стилей, например «January» и «Jan».- Доступно с версии: 1.6 См. также:
SHORT_FORMAT,LONG_FORMAT,SHORT_STANDALONE,LONG_STANDALONE,SHORT,LONG, Значение константного поля
-
SHORT
public static final int SHORT
- Доступно с версии: 1.6 См. также:
SHORT_STANDALONE,LONG, Значение константного поля
-
LONG
public static final int LONG
- Доступно с версии: 1.6 См. также:
LONG_STANDALONE,SHORT, Значение константного поля
-
NARROW_FORMAT
public static final int NARROW_FORMAT
getDisplayNameиgetDisplayNamesспецификатор стиля для, указывающий узкие названия для формата. Узкое название обычно представляет собой одну строку, например «M» для понедельника.- Доступно с версии: 1.8 См. также:
NARROW_STANDALONE,SHORT_FORMAT,LONG_FORMAT, Значение константного поля
-
NARROW_STANDALONE
public static final int NARROW_STANDALONE
getDisplayNameиgetDisplayNamesспецификатор стиля для, указывающий узкие названия отдельно. Узкое название обычно представляет собой одну строку, например «M» для понедельника.- Доступно с версии: 1.8 См. также:
NARROW_FORMAT,SHORT_STANDALONE,LONG_STANDALONE, Значение константного поля
-
SHORT_FORMAT
public static final int SHORT_FORMAT
- Доступно с версии: 1.8 См. также:
SHORT_STANDALONE,LONG_FORMAT,LONG_STANDALONE, значение константного поля
-
LONG_FORMAT
public static final int LONG_FORMAT
- Начиная с версии: 1.8 См. также:
LONG_STANDALONE,SHORT_FORMAT,SHORT_STANDALONE, значение константного поля
-
SHORT_STANDALONE
public static final int SHORT_STANDALONE
getDisplayNameиgetDisplayNames— спецификатор стиля, указывающий короткое имя для самостоятельного использования, например сокращение месяца как заголовок календаря.- Начиная с версии: 1.8 См. также:
SHORT_FORMAT,LONG_FORMAT,LONG_STANDALONE, значение константного поля
-
LONG_STANDALONE
public static final int LONG_STANDALONE
getDisplayNameиgetDisplayNames— спецификатор стиля, указывающий длинное имя для самостоятельного использования, например название месяца как заголовок календаря.- Начиная с версии: 1.8 См. также:
LONG_FORMAT,SHORT_FORMAT,SHORT_STANDALONE, значение константного поля
-
字段
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()
-
-
方法详细信息
-
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экземпляры.
-
computeTime
protected abstract void computeTime()
Выполняетfields[]Преобразует текущие значения полей календаря в значение времени в миллисекундах.time。- Смотрите также:
complete(),computeFields()
-
computeFields
protected abstract void computeFields()
Преобразует текущее значение времени в миллисекундах вtimeзначения полей календаряfields[]. Это позволяет синхронизировать значения полей календаря с новым временем, установленным для календаря. Время сначала не пересчитывается. Чтобы пересчитать время, а затем поля, вызовите методcomplete().- Смотрите также:
computeTime()
-
getTime
public final Date getTime()
- Результат
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
-
hashCode
public int hashCode()
Возвращает хеш-код этого календаря.- Переопределяет:
hashCode, классObject- Результат: значение хеш-кода этого объекта. Начиная с версии: 1.2 См. также:
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
before
public boolean before(Object when)
Возвращает, обозначает ли этотCalendar是否表示指定的Object. Этот метод эквивалентен следующему:当且仅当compareTo(when) < 0when是Calendar. Иначе метод возвращаетfalse。- Параметры
when- 待比较的Object- для сравнения. Результат
truetrue, если время, которое задаёт этотCalendar, раньше времени, заданногоwhen; иначеfalse. См. также:compareTo(Calendar)
-
after
public boolean after(Object when)
Возвращает, обозначает ли этотCalendar是否表示指定的Object. Этот метод эквивалентен следующему:当且仅当compareTo(when) > 0when是Calendar. Иначе метод возвращаетfalse。- Параметры
when- 待比较的Object- Результат
true如果此Calendar的时间when于whenпредставляет указанный объект; иначе false. См. также:falsecompareTocompareTo(Calendar)
-
compareTo
public int compareTo(Calendar anotherCalendar)
Сравнивает значения времени, которые представляют дваCalendarобъекта (смещение в миллисекундах от начала Epoch).- Определено в:
compareToв интерфейсеComparable<Calendar>- Параметры
anotherCalendar- 待比较的Calendar. Результат: значение00, если время, которое представляет параметр, равно времени этого объектаCalendar; значение меньшеCalendar0, если время этого объекта раньше времени параметра0; значение большеCalendar0, если время этого объекта позже времени параметра0. ИсключенияNullPointerExceptionNullPointerException - если указанныйCalendarобъектnullравен null.IllegalArgumentException- если значение времени указанного объекта нельзя получить из-за недопустимых значений календаря. Начиная с версии: 1.5Calendaradd
-
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 — это первый день недели. Реализация этого метода по умолчанию выбрасывает- Результат — этот
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-lenientUnsupportedOperationException- 如果此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для григорианской календарной системы метод возвращает 28DAY_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()
Создаёт и возвращает копию этого объекта.
-
toString
public String toString()
Возвращает строковое представление этого календаря. Этот метод предназначен только для отладки, формат строки зависит от реализации. Возвращаемая строка может быть пустой, но не может бытьnull。
-
-