GregorianCalendar (Платформа Java SE 8 b92)

java.lang. Объект
- java.util. Календарь
- - java.util. GregorianCalendar

Все Реализованные Интерфейсы:: Сериализуемый, Cloneable, Сопоставимый <Календарь>

public class GregorianCalendar
extends Calendar

GregorianCalendar конкретный подкласс Calendar и обеспечивает стандартную календарную систему, используемую большей частью мира.

GregorianCalendar гибридный календарь, который поддерживает и системы Юлианского и Григорианского календаря с поддержкой единственного разрыва, который соответствует по умолчанию Грегорианской дате, когда Григорианский календарь был установлен (15 октября 1582 в некоторых странах, позже в других). cutover дата может быть изменена вызывающей стороной, вызывая setGregorianChange().

Исторически, в тех странах, которые приняли Григорианский календарь сначала, 4 октября 1582 (Юлианский), таким образом сопровождался к 15 октября 1582 (Грегорианский). Этот календарь моделирует это правильно. Перед Грегорианским cutover, GregorianCalendar реализует юлианский календарь. Единственной разницей между Грегорианским и юлианским календарем является правило високосного года. Каждые четыре года юлианский календарь определяет високосные годы, тогда как Григорианский календарь опускает годы столетия, которые не являются делимыми 400.

GregorianCalendar реализует преждевременные Григорианские и юлианские календари. Таким образом, даты вычисляются, экстраполируя текущие правила неопределенно далеко назад и передайте вовремя. В результате GregorianCalendar может использоваться в течение всех лет, чтобы генерировать значимые и непротиворечивые результаты. Однако, даты получили использование GregorianCalendar исторически точны только с 1 марта, 4 AD вперед, когда современные правила юлианского календаря были приняты. Перед этой датой правила високосного года были применены нерегулярно, и перед 45 BC, юлианский календарь даже не существовал.

До учреждения Григорианского календаря Новый год был 25 марта. Чтобы избежать беспорядка, этот календарь всегда использует 1 января. Ручная настройка может быть сделана при желании для дат, которые являются до Грегорианского переключения и которые падают между 1 января и 24 марта.

Неделя Года Года и Недели

Значения, вычисленные для WEEK_OF_YEAR полевой диапазон от 1 до 53. Первая неделя календарного года является самым ранним семидневным периодом, запускающимся на getFirstDayOfWeek() это содержит, по крайней мере, getMinimalDaysInFirstWeek() дни с того года. Это таким образом зависит от значений getMinimalDaysInFirstWeek(), getFirstDayOfWeek(), и день недели от 1 января. Недели между неделей 1 из одного года и неделей 1 из следующего (монопольного) года нумеруются последовательно от 2 до 52 или 53 (за исключением года (лет), включенного в Юлианско-грегорианский переход).

getFirstDayOfWeek() и getMinimalDaysInFirstWeek() значения инициализируются, используя зависимые от локали ресурсы, создавая a GregorianCalendar. Недельное определение является совместимым со стандартом ISO 8601 когда getFirstDayOfWeek() MONDAY и getMinimalDaysInFirstWeek() 4, какие значения используются в локалях, где стандарт предпочитается. Эти значения могут явно быть установлены, вызывая setFirstDayOfWeek() и setMinimalDaysInFirstWeek().

Недельный год находится в синхронизации с a WEEK_OF_YEAR цикл. У всех недель между первыми и последними неделями (включительно) есть то же самое недельное значение года. Поэтому, у первых и последних дней недельного года могут быть различные значения календарного года.

Например, 1 января 1998 четверг. Если getFirstDayOfWeek() MONDAY и getMinimalDaysInFirstWeek() 4 (стандарт ISO 8601 совместимая установка), тогда неделя 1 из 1998 запускается 29 декабря 1997, и заканчивается 4 января 1998. Недельный год является 1998 в течение прошлых трех дней календарного года 1997. Если, однако, getFirstDayOfWeek() SUNDAY, тогда неделя 1 из 1998 запускается 4 января 1998, и заканчивается 10 января 1998; первые три дня 1998 тогда являются частью недели, 53 из 1997 и их недельного года являются 1997.

Неделя Месяца

Значения, вычисленные для WEEK_OF_MONTH полевой диапазон от 0 до 6. Неделя 1 из месяца (дни с WEEK_OF_MONTH = 1) самый ранний набор, по крайней мере, getMinimalDaysInFirstWeek() непрерывные дни в том месяце, заканчивающийся в день прежде getFirstDayOfWeek(). В отличие от недели 1 из года, недели 1 из месяца может быть короче чем 7 дней, не должен запуститься на getFirstDayOfWeek(), и не будет включать дни предыдущего месяца. У дней месяца перед неделей 1 есть a WEEK_OF_MONTH из 0.

Например, если getFirstDayOfWeek() SUNDAY и getMinimalDaysInFirstWeek() 4, тогда первая неделя января 1998 воскресенье, 4 января в течение субботы, 10 января. У этих дней есть a WEEK_OF_MONTH из 1. Четверг, 1 января в течение субботы, 3 января имейте a WEEK_OF_MONTH из 0. Если getMinimalDaysInFirstWeek() изменяется на 3, тогда 1 января в течение 3 января имейте a WEEK_OF_MONTH из 1.

Полевые Значения значения по умолчанию

clear метод устанавливает календарное неопределенное поле (я). GregorianCalendar использует следующее значение по умолчанию для каждого календарного поля, если его значение неопределено.

Поле	Значение по умолчанию
`ERA`	`AD`
`YEAR`	`1970`
`MONTH`	`JANUARY`
`DAY_OF_MONTH`	`1`
`DAY_OF_WEEK`	`the first day of week`
`WEEK_OF_MONTH`	`0`
`DAY_OF_WEEK_IN_MONTH`	`1`
`AM_PM`	`AM`
`HOUR, HOUR_OF_DAY, MINUTE, SECOND, MILLISECOND`	`0`

Значения по умолчанию не применимы для полей, не упомянутых выше.

Пример:

 // get the supported ids for GMT-08:00 (Pacific Standard Time)
 String[] ids = TimeZone.getAvailableIDs(-8 * 60 * 60 * 1000);
 // if no ids were returned, something is wrong. get out.
 if (ids.length == 0)
     System.exit(0);

  // begin output
 System.out.println("Current Time");

 // create a Pacific Standard Time time zone
 SimpleTimeZone pdt = new SimpleTimeZone(-8 * 60 * 60 * 1000, ids[0]);

 // set up rules for Daylight Saving Time
 pdt.setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2 * 60 * 60 * 1000);
 pdt.setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 2 * 60 * 60 * 1000);

 // create a GregorianCalendar with the Pacific Daylight time zone
 // and the current date and time
 Calendar calendar = new GregorianCalendar(pdt);
 Date trialTime = new Date();
 calendar.setTime(trialTime);

 // print out a bunch of interesting things
 System.out.println("ERA: " + calendar.get(Calendar.ERA));
 System.out.println("YEAR: " + calendar.get(Calendar.YEAR));
 System.out.println("MONTH: " + calendar.get(Calendar.MONTH));
 System.out.println("WEEK_OF_YEAR: " + calendar.get(Calendar.WEEK_OF_YEAR));
 System.out.println("WEEK_OF_MONTH: " + calendar.get(Calendar.WEEK_OF_MONTH));
 System.out.println("DATE: " + calendar.get(Calendar.DATE));
 System.out.println("DAY_OF_MONTH: " + calendar.get(Calendar.DAY_OF_MONTH));
 System.out.println("DAY_OF_YEAR: " + calendar.get(Calendar.DAY_OF_YEAR));
 System.out.println("DAY_OF_WEEK: " + calendar.get(Calendar.DAY_OF_WEEK));
 System.out.println("DAY_OF_WEEK_IN_MONTH: "
                    + calendar.get(Calendar.DAY_OF_WEEK_IN_MONTH));
 System.out.println("AM_PM: " + calendar.get(Calendar.AM_PM));
 System.out.println("HOUR: " + calendar.get(Calendar.HOUR));
 System.out.println("HOUR_OF_DAY: " + calendar.get(Calendar.HOUR_OF_DAY));
 System.out.println("MINUTE: " + calendar.get(Calendar.MINUTE));
 System.out.println("SECOND: " + calendar.get(Calendar.SECOND));
 System.out.println("MILLISECOND: " + calendar.get(Calendar.MILLISECOND));
 System.out.println("ZONE_OFFSET: "
                    + (calendar.get(Calendar.ZONE_OFFSET)/(60*60*1000)));
 System.out.println("DST_OFFSET: "
                    + (calendar.get(Calendar.DST_OFFSET)/(60*60*1000)));

 System.out.println("Current Time, with hour reset to 3");
 calendar.clear(Calendar.HOUR_OF_DAY); // so doesn't override
 calendar.set(Calendar.HOUR, 3);
 System.out.println("ERA: " + calendar.get(Calendar.ERA));
 System.out.println("YEAR: " + calendar.get(Calendar.YEAR));
 System.out.println("MONTH: " + calendar.get(Calendar.MONTH));
 System.out.println("WEEK_OF_YEAR: " + calendar.get(Calendar.WEEK_OF_YEAR));
 System.out.println("WEEK_OF_MONTH: " + calendar.get(Calendar.WEEK_OF_MONTH));
 System.out.println("DATE: " + calendar.get(Calendar.DATE));
 System.out.println("DAY_OF_MONTH: " + calendar.get(Calendar.DAY_OF_MONTH));
 System.out.println("DAY_OF_YEAR: " + calendar.get(Calendar.DAY_OF_YEAR));
 System.out.println("DAY_OF_WEEK: " + calendar.get(Calendar.DAY_OF_WEEK));
 System.out.println("DAY_OF_WEEK_IN_MONTH: "
                    + calendar.get(Calendar.DAY_OF_WEEK_IN_MONTH));
 System.out.println("AM_PM: " + calendar.get(Calendar.AM_PM));
 System.out.println("HOUR: " + calendar.get(Calendar.HOUR));
 System.out.println("HOUR_OF_DAY: " + calendar.get(Calendar.HOUR_OF_DAY));
 System.out.println("MINUTE: " + calendar.get(Calendar.MINUTE));
 System.out.println("SECOND: " + calendar.get(Calendar.SECOND));
 System.out.println("MILLISECOND: " + calendar.get(Calendar.MILLISECOND));
 System.out.println("ZONE_OFFSET: "
        + (calendar.get(Calendar.ZONE_OFFSET)/(60*60*1000))); // in hours
 System.out.println("DST_OFFSET: "
        + (calendar.get(Calendar.DST_OFFSET)/(60*60*1000))); // in hours

С тех пор:: JDK1.1
См. Также:: TimeZone, Сериализированная Форма

Вложенная Сводка Класса
- Вложенные классы/интерфейсы, наследованные от class java.util. Календарь
  Календарь. Разработчик

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static int`	`AD` Значение `ERA` поле, указывающее на нашу эру (Нашей эры), также известный как CE.
`static int`	`BC` Значение `ERA` поле, указывающее на период перед нашей эрой (до рождества Христова), также известный как BCE.

Поля, наследованные от class java.util. Календарь
ALL_STYLES, AM, AM_PM, APRIL, areFieldsSet, AUGUST, DATE, DAY_OF_MONTH, DAY_OF_WEEK, DAY_OF_WEEK_IN_MONTH, DAY_OF_YEAR, DECEMBER, DST_OFFSET, ERA, FEBRUARY, FIELD_COUNT, fields, FRIDAY, HOUR, HOUR_OF_DAY, isSet, isTimeSet, JANUARY, JULY, JUNE, LONG, LONG_FORMAT, LONG_STANDALONE, MARCH, MAY, MILLISECOND, MINUTE, MONDAY, MONTH, NARROW_FORMAT, NARROW_STANDALONE, NOVEMBER, OCTOBER, PM, SATURDAY, SECOND, SEPTEMBER, SHORT, SHORT_FORMAT, SHORT_STANDALONE, SUNDAY, THURSDAY, time, TUESDAY, UNDECIMBER, WEDNESDAY, WEEK_OF_MONTH, WEEK_OF_YEAR, YEAR, ZONE_OFFSET

Сводка конструктора

Конструкторы
Конструктор и Описание
`GregorianCalendar()` Создает значение по умолчанию `GregorianCalendar` использование текущего времени в часовом поясе значения по умолчанию со значением по умолчанию `FORMAT` локаль.
`GregorianCalendar(int year, int month, int dayOfMonth)` Конструкции a `GregorianCalendar` с данным набором даты в часовом поясе значения по умолчанию с локалью значения по умолчанию.
`GregorianCalendar(int year, int month, int dayOfMonth, int hourOfDay, int minute)` Конструкции a `GregorianCalendar` с данной датой и время устанавливается для часового пояса значения по умолчанию с локалью значения по умолчанию.
`GregorianCalendar(int year, int month, int dayOfMonth, int hourOfDay, int minute, int second)` Создает GregorianCalendar с данной датой и набором времени для часового пояса значения по умолчанию с локалью значения по умолчанию.
`GregorianCalendar(Locale aLocale)` Конструкции a `GregorianCalendar` основанный на текущем времени в часовом поясе значения по умолчанию с данной локалью.
`GregorianCalendar(TimeZone zone)` Конструкции a `GregorianCalendar` основанный на текущем времени в данном часовом поясе со значением по умолчанию `FORMAT` локаль.
`GregorianCalendar(TimeZone zone, Locale aLocale)` Конструкции a `GregorianCalendar` основанный на текущем времени в данном часовом поясе с данной локалью.

Сводка метода

Все Методы Статические Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`void`	`add(int field, int amount)` Добавляет указанное (подписанное) количество времени к данному календарному полю, основанному на правилах календаря.
`Объект`	`clone()` Создает и возвращает копию этого объекта.
`protected void`	`computeFields()` Преобразовывает временную стоимость (смещение миллисекунды от Эпохи) к календарным значениям полей.
`protected void`	`computeTime()` Преобразовывает календарные значения полей во временную стоимость (смещение миллисекунды от Эпохи).
`boolean`	`equals(Object obj)` Сравнивает это `GregorianCalendar` к указанному `Object`.
`static GregorianCalendar`	`from(ZonedDateTime zdt)` Получает экземпляр `GregorianCalendar` с локалью значения по умолчанию от a `ZonedDateTime` объект.
`int`	`getActualMaximum(int field)` Возвращает максимальное значение, которое это календарное поле могло иметь, учитывая данную временную стоимость и текущую стоимость `getFirstDayOfWeek`, `getMinimalDaysInFirstWeek`, `getGregorianChange` и `getTimeZone` методы.
`int`	`getActualMinimum(int field)` Возвращает минимальное значение, которое это календарное поле могло иметь, учитывая данную временную стоимость и текущую стоимость `getFirstDayOfWeek`, `getMinimalDaysInFirstWeek`, `getGregorianChange` и `getTimeZone` методы.
`Строка`	`getCalendarType()` Возвраты `"gregory"` как тип календаря.
`int`	`getGreatestMinimum(int field)` Возвращает самое высокое минимальное значение для данного календарного поля этого `GregorianCalendar` экземпляр.
`Дата`	`getGregorianChange()` Получает дату изменения Григорианского календаря.
`int`	`getLeastMaximum(int field)` Возвращает самое низкое максимальное значение для данного календарного поля этого `GregorianCalendar` экземпляр.
`int`	`getMaximum(int field)` Возвращает максимальное значение для данного календарного поля этого `GregorianCalendar` экземпляр.
`int`	`getMinimum(int field)` Возвращает минимальное значение для данного календарного поля этого `GregorianCalendar` экземпляр.
`TimeZone`	`getTimeZone()` Получает часовой пояс.
`int`	`getWeeksInWeekYear()` Возвращает число недель, в недельном году представленных этим `GregorianCalendar`.
`int`	`getWeekYear()` Возвращает недельный год, представленный этим `GregorianCalendar`.
`int`	`hashCode()` Генерирует хэш-код для этого `GregorianCalendar` объект.
`boolean`	`isLeapYear(int year)` Определяет, является ли данный год високосным годом.
`boolean`	`isWeekDateSupported()` Возвраты `true` указание на это `GregorianCalendar` поддерживает недельные даты.
`void`	`roll(int field, boolean up)` Добавляет или вычитает (/вниз) единый блок времени на данном поле времени, не изменяя более крупные поля.
`void`	`roll(int field, int amount)` Добавляет подписанное количество к указанному календарному полю, не изменяя более крупные поля.
`void`	`setGregorianChange(Date date)` Наборы `GregorianCalendar` дата изменения.
`void`	`setTimeZone(TimeZone zone)` Устанавливает часовой пояс с данным значением часового пояса.
`void`	`setWeekDate(int weekYear, int weekOfYear, int dayOfWeek)` Наборы это `GregorianCalendar` к дате, данной спецификаторами даты - `weekYear`, `weekOfYear`, и `dayOfWeek`.
`ZonedDateTime`	`toZonedDateTime()` Преобразовывает этот объект в a `ZonedDateTime` это представляет ту же самую точку на временной шкале как это `GregorianCalendar`.

Методы, наследованные от class java.util. Календарь
after, before, clear, clear, compareTo, complete, get, getAvailableCalendarTypes, getAvailableLocales, getDisplayName, getDisplayNames, getFirstDayOfWeek, getInstance, getInstance, getInstance, getInstance, getMinimalDaysInFirstWeek, getTime, getTimeInMillis, internalGet, isLenient, isSet, set, set, set, set, setFirstDayOfWeek, setLenient, setMinimalDaysInFirstWeek, setTime, setTimeInMillis, toInstant, toString

Методы, наследованные от class java.lang. Объект
finalize, getClass, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - BC
```
public static final int BC
```
    Значение ERA поле, указывающее на период перед нашей эрой (до рождества Христова), также известный как BCE. Последовательность лет при переходе от BC к AD ..., 2 BC, 1 BC, 1 AD, 2 AD...
    
    См. Также:
    
    Calendar.ERA, Постоянные Значения полей
  - AD
```
public static final int AD
```
    Значение ERA поле, указывающее на нашу эру (Нашей эры), также известный как CE. Последовательность лет при переходе от BC к AD ..., 2 BC, 1 BC, 1 AD, 2 AD...
    
    См. Также:
    
    Calendar.ERA, Постоянные Значения полей
- Деталь конструктора
  - GregorianCalendar
```
public GregorianCalendar()
```
    Создает значение по умолчанию GregorianCalendar использование текущего времени в часовом поясе значения по умолчанию со значением по умолчанию FORMAT локаль.
  - GregorianCalendar
```
public GregorianCalendar(TimeZone zone)
```
    Конструкции a GregorianCalendar основанный на текущем времени в данном часовом поясе со значением по умолчанию FORMAT локаль.
    
    Параметры:
    
    zone - данный часовой пояс.
  - GregorianCalendar
```
public GregorianCalendar(Locale aLocale)
```
    Конструкции a GregorianCalendar основанный на текущем времени в часовом поясе значения по умолчанию с данной локалью.
    
    Параметры:
    
    aLocale - данная локаль.
  - GregorianCalendar
```
public GregorianCalendar(TimeZone zone,
                         Locale aLocale)
```
    Конструкции a GregorianCalendar основанный на текущем времени в данном часовом поясе с данной локалью.
    
    Параметры:
    
    zone - данный часовой пояс.
    
    aLocale - данная локаль.
  - GregorianCalendar
```
public GregorianCalendar(int year,
                         int month,
                         int dayOfMonth)
```
    Конструкции a GregorianCalendar с данным набором даты в часовом поясе значения по умолчанию с локалью значения по умолчанию.
    
    Параметры:
    
    year - значение, используемое, чтобы установить YEAR календарное поле в календаре.
    
    month - значение, используемое, чтобы установить MONTH календарное поле в календаре. Значение месяца на основе 0. например, 0 на январь.
    
    dayOfMonth - значение, используемое, чтобы установить DAY_OF_MONTH календарное поле в календаре.
  - GregorianCalendar
```
public GregorianCalendar(int year,
                         int month,
                         int dayOfMonth,
                         int hourOfDay,
                         int minute)
```
    Конструкции a GregorianCalendar с данной датой и время устанавливается для часового пояса значения по умолчанию с локалью значения по умолчанию.
    
    Параметры:
    
    year - значение, используемое, чтобы установить YEAR календарное поле в календаре.
    
    month - значение, используемое, чтобы установить MONTH календарное поле в календаре. Значение месяца на основе 0. например, 0 на январь.
    
    dayOfMonth - значение, используемое, чтобы установить DAY_OF_MONTH календарное поле в календаре.
    
    hourOfDay - значение, используемое, чтобы установить HOUR_OF_DAY календарное поле в календаре.
    
    minute - значение, используемое, чтобы установить MINUTE календарное поле в календаре.
  - GregorianCalendar
```
public GregorianCalendar(int year,
                         int month,
                         int dayOfMonth,
                         int hourOfDay,
                         int minute,
                         int second)
```
    Создает GregorianCalendar с данной датой и набором времени для часового пояса значения по умолчанию с локалью значения по умолчанию.
    
    Параметры:
    
    year - значение, используемое, чтобы установить YEAR календарное поле в календаре.
    
    month - значение, используемое, чтобы установить MONTH календарное поле в календаре. Значение месяца на основе 0. например, 0 на январь.
    
    dayOfMonth - значение, используемое, чтобы установить DAY_OF_MONTH календарное поле в календаре.
    
    hourOfDay - значение, используемое, чтобы установить HOUR_OF_DAY календарное поле в календаре.
    
    minute - значение, используемое, чтобы установить MINUTE календарное поле в календаре.
    
    second - значение, используемое, чтобы установить SECOND календарное поле в календаре.
- Деталь метода
  - setGregorianChange
```
public void setGregorianChange(Date date)
```
    Наборы GregorianCalendar дата изменения. Это - точка, когда переключатель от дат Джулиана до Грегорианских дат произошел. Значение по умолчанию является 15 октября 1582 (Грегорианским). До этого даты будут в юлианском календаре.
    Чтобы получить чистый юлианский календарь, назначьте дату изменения к Date(Long.MAX_VALUE). Чтобы получить чистый Григорианский календарь, назначьте дату изменения к Date(Long.MIN_VALUE).
    
    Параметры:
    
    date - данная Грегорианская cutover дата.
  - getGregorianChange
```
public final Date getGregorianChange()
```
    Получает дату изменения Григорианского календаря. Это - точка, когда переключатель от дат Джулиана до Грегорианских дат произошел. Значение по умолчанию является 15 октября 1582 (Грегорианским). До этого даты будут в юлианском календаре.
    
    Возвраты:
    
    Грегорианская cutover дата этого GregorianCalendar объект.
  - isLeapYear
```
public boolean isLeapYear(int year)
```
    Определяет, является ли данный год високосным годом. Возвраты true если данный год является високосным годом. Определить числа года BC, 1 - year number должен быть дан. Например, BC года 4 определяется как-3.
    
    Параметры:
    
    year - данный год.
    
    Возвраты:
    
    true если данный год является високосным годом; false иначе.
  - getCalendarType
```
public String getCalendarType()
```
    Возвраты "gregory" как тип календаря.
    
    Переопределения:
    
    getCalendarType в class Calendar
    
    Возвраты:
    
    "gregory"
    
    С тех пор:
    
    1.8
    
    См. Также:
    
    Расширения локали, Locale.Builder.setLocale(Locale), Locale.Builder.setUnicodeLocaleKeyword(String, String)
  - равняется
```
public boolean equals(Object obj)
```
    Сравнивает это GregorianCalendar к указанному Object. Результат true если и только если параметром является a GregorianCalendar объект, который представляет ту же самую временную стоимость (смещение миллисекунды от Эпохи) под тем же самым Calendar параметры и Грегорианская дата изменения как этот объект.
    
    Переопределения:
    
    equals в class Calendar
    
    Параметры:
    
    obj - объект сравниться с.
    
    Возвраты:
    
    true если этот объект равен obj; false иначе.
    
    См. Также:
    
    Calendar.compareTo(Calendar)
  - хэш-код
```
public int hashCode()
```
    Генерирует хэш-код для этого GregorianCalendar объект.
    
    Переопределения:
    
    hashCode в class Calendar
    
    Возвраты:
    
    значение хэш-кода для этого объекта.
    
    См. Также:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - добавить
```
public void add(int field,
                int amount)
```
    Добавляет указанное (подписанное) количество времени к данному календарному полю, основанному на правилах календаря.
    Добавьте правило 1. Значение field после вызова минус значение field прежде, чем вызов amount, по модулю любое переполнение, которое произошло в field. Переполнение происходит, когда значение поля превышает свой диапазон, и, в результате следующее более крупное поле постепенно увеличивается или постепенно уменьшается, и значение поля корректируется назад в его диапазон.
    
    Добавьте правило 2. Если меньшее поле, как ожидают, будет инвариантным, но для этого невозможно быть равным его предшествующему значению из-за изменений в его минимуме или максимуме после field изменяется, тогда его значение корректируется, чтобы быть настолько близким насколько возможно к его математическому ожиданию. Меньшее поле представляет меньшую единицу времени. HOUR меньшее поле чем DAY_OF_MONTH. Никакая корректировка не вносится в меньшие поля, которые, как ожидают, не будут инвариантными. Календарная система определяет, какие поля, как ожидают, будут инвариантными.
    
    Определенный:
    
    add в class Calendar
    
    Параметры:
    
    field - календарное поле.
    
    amount - количество даты или время, которое будет добавлено к полю.
    
    Броски:
    
    IllegalArgumentException - если field ZONE_OFFSET, DST_OFFSET, или неизвестный, или если у каких-либо календарных полей есть значения из диапазона в неснисходительном режиме.
    
    См. Также:
    
    Calendar.roll(int,int), Calendar.set(int,int)
  - рулон
```
public void roll(int field,
                 boolean up)
```
    Добавляет или вычитает (/вниз) единый блок времени на данном поле времени, не изменяя более крупные поля.
    Пример: Рассмотрите a GregorianCalendar первоначально набор до 31 декабря 1999. Вызов roll(Calendar.MONTH, true) устанавливает календарь до 31 января 1999. YEAR поле неизменно, потому что это - более крупное поле чем MONTH.
    
    Определенный:
    
    roll в class Calendar
    
    Параметры:
    
    up - указывает, должно ли значение указанного календарного поля быть свернуто или скатиться. Использовать true свертываясь, false иначе.
    
    field - поле времени.
    
    Броски:
    
    IllegalArgumentException - если field ZONE_OFFSET, DST_OFFSET, или неизвестный, или если у каких-либо календарных полей есть значения из диапазона в неснисходительном режиме.
    
    См. Также:
    
    add(int,int), Calendar.set(int,int)
  - рулон
```
public void roll(int field,
                 int amount)
```
    Добавляет подписанное количество к указанному календарному полю, не изменяя более крупные поля. Отрицательное количество рулона означает вычитать из поля, не изменяя более крупные поля. Если указанное количество 0, этот метод ничего не выполняет.
    Это вызовы метода Calendar.complete() прежде, чем добавить количество так, чтобы все календарные поля были нормализованы. Если есть любое календарное поле, имеющее значение из диапазона в неснисходительном режиме, то IllegalArgumentException бросается.
    Пример: Рассмотрите a GregorianCalendar первоначально набор до 31 августа 1999. Вызов roll(Calendar.MONTH, 8) устанавливает календарь до 30 апреля 1999. Используя a GregorianCalendar, DAY_OF_MONTH поле не может быть 31 в апреле месяца. DAY_OF_MONTH устанавливается в самое близкое значение, 30. YEAR поле поддерживает значение 1999, потому что это - более крупное поле чем MONTH.
    Пример: Рассмотрите a GregorianCalendar первоначально набор к воскресенье 6 июня 1999. Вызов roll(Calendar.WEEK_OF_MONTH, -1) устанавливает календарь во вторник 1 июня 1999, тогда как вызов add(Calendar.WEEK_OF_MONTH, -1) устанавливает календарь в воскресенье 30 мая 1999. Это - то, потому что правило рулона налагает дополнительное ограничение: MONTH не должен измениться когда WEEK_OF_MONTH прокручивается. Взятый вместе с добавляют правило 1, результирующая дата должна быть между вторник 1 июня и суббота 5 июня. Согласно добавляют правило 2, DAY_OF_WEEK, инвариант, изменяясь WEEK_OF_MONTH, устанавливается во вторник, самое близкое значение к воскресенью (где воскресенье является первым днем недели).
    
    Переопределения:
    
    roll в class Calendar
    
    Параметры:
    
    field - календарное поле.
    
    amount - подписанное количество, чтобы добавить к field.
    
    Броски:
    
    IllegalArgumentException - если field ZONE_OFFSET, DST_OFFSET, или неизвестный, или если у каких-либо календарных полей есть значения из диапазона в неснисходительном режиме.
    
    С тех пор:
    
    1.2
    
    См. Также:
    
    roll(int,boolean), add(int,int), Calendar.set(int,int)
  - getMinimum
```
public int getMinimum(int field)
```
    Возвращает минимальное значение для данного календарного поля этого GregorianCalendar экземпляр. Минимальное значение определяется как самое маленькое значение, возвращенное get метод для любой возможной временной стоимости, учитывая текущую стоимость getFirstDayOfWeek, getMinimalDaysInFirstWeek, getGregorianChange и getTimeZone методы.
    
    Определенный:
    
    getMinimum в class Calendar
    
    Параметры:
    
    field - календарное поле.
    
    Возвраты:
    
    минимальное значение для данного календарного поля.
    
    См. Также:
    
    getMaximum(int), getGreatestMinimum(int), getLeastMaximum(int), getActualMinimum(int), getActualMaximum(int)
  - getMaximum
```
public int getMaximum(int field)
```
    Возвращает максимальное значение для данного календарного поля этого GregorianCalendar экземпляр. Максимальное значение определяется как самое большое значение, возвращенное get метод для любой возможной временной стоимости, учитывая текущую стоимость getFirstDayOfWeek, getMinimalDaysInFirstWeek, getGregorianChange и getTimeZone методы.
    
    Определенный:
    
    getMaximum в class Calendar
    
    Параметры:
    
    field - календарное поле.
    
    Возвраты:
    
    максимальное значение для данного календарного поля.
    
    См. Также:
    
    getMinimum(int), getGreatestMinimum(int), getLeastMaximum(int), getActualMinimum(int), getActualMaximum(int)
  - getGreatestMinimum
```
public int getGreatestMinimum(int field)
```
    Возвращает самое высокое минимальное значение для данного календарного поля этого GregorianCalendar экземпляр. Самое высокое минимальное значение определяется как самое большое значение, возвращенное getActualMinimum(int) для любой возможной временной стоимости, учитывая текущую стоимость getFirstDayOfWeek, getMinimalDaysInFirstWeek, getGregorianChange и getTimeZone методы.
    
    Определенный:
    
    getGreatestMinimum в class Calendar
    
    Параметры:
    
    field - календарное поле.
    
    Возвраты:
    
    самое высокое минимальное значение для данного календарного поля.
    
    См. Также:
    
    getMinimum(int), getMaximum(int), getLeastMaximum(int), getActualMinimum(int), getActualMaximum(int)
  - getLeastMaximum
```
public int getLeastMaximum(int field)
```
    Возвращает самое низкое максимальное значение для данного календарного поля этого GregorianCalendar экземпляр. Самое низкое максимальное значение определяется как самое маленькое значение, возвращенное getActualMaximum(int) для любой возможной временной стоимости, учитывая текущую стоимость getFirstDayOfWeek, getMinimalDaysInFirstWeek, getGregorianChange и getTimeZone методы.
    
    Определенный:
    
    getLeastMaximum в class Calendar
    
    Параметры:
    
    field - календарное поле
    
    Возвраты:
    
    самое низкое максимальное значение для данного календарного поля.
    
    См. Также:
    
    getMinimum(int), getMaximum(int), getGreatestMinimum(int), getActualMinimum(int), getActualMaximum(int)
  - getActualMinimum
```
public int getActualMinimum(int field)
```
    Возвращает минимальное значение, которое это календарное поле могло иметь, учитывая данную временную стоимость и текущую стоимость getFirstDayOfWeek, getMinimalDaysInFirstWeek, getGregorianChange и getTimeZone методы.
    Например, если Грегорианская дата изменения 10 января 1970 и дата этого GregorianCalendar 20 января 1970, фактическое минимальное значение DAY_OF_MONTH поле 10, потому что предыдущая дата от 10 января 1970 27 декабря 1996 (в юлианском календаре). Поэтому, 28 декабря 1969 до 9 января 1970 не существуйте.
    
    Переопределения:
    
    getActualMinimum в class Calendar
    
    Параметры:
    
    field - календарное поле
    
    Возвраты:
    
    минимум данного поля для временной стоимости этого GregorianCalendar
    
    С тех пор:
    
    1.2
    
    См. Также:
    
    getMinimum(int), getMaximum(int), getGreatestMinimum(int), getLeastMaximum(int), getActualMaximum(int)
  - getActualMaximum
```
public int getActualMaximum(int field)
```
    Возвращает максимальное значение, которое это календарное поле могло иметь, учитывая данную временную стоимость и текущую стоимость getFirstDayOfWeek, getMinimalDaysInFirstWeek, getGregorianChange и getTimeZone методы. Например, если дата этого экземпляра 1 февраля 2004, фактическое максимальное значение DAY_OF_MONTH поле 29, потому что 2004 является високосным годом, и если дата этого экземпляра 1 февраля 2005, это 28.
    Этот метод вычисляет максимальное значение WEEK_OF_YEAR основанный на YEAR (календарный год) значение, не недельный год. Вызвать getWeeksInWeekYear() получить максимальное значение WEEK_OF_YEAR в недельном году этого GregorianCalendar.
    
    Переопределения:
    
    getActualMaximum в class Calendar
    
    Параметры:
    
    field - календарное поле
    
    Возвраты:
    
    максимум данного поля для временной стоимости этого GregorianCalendar
    
    С тех пор:
    
    1.2
    
    См. Также:
    
    getMinimum(int), getMaximum(int), getGreatestMinimum(int), getLeastMaximum(int), getActualMinimum(int)
  - клон
```
public Object clone()
```
    Описание скопировало с class: Calendar
    
    Создает и возвращает копию этого объекта.
    
    Переопределения:
    
    clone в class Calendar
    
    Возвраты:
    
    копия этого объекта.
    
    См. Также:
    
    Cloneable
  - getTimeZone
```
public TimeZone getTimeZone()
```
    Описание скопировало с class: Calendar
    
    Получает часовой пояс.
    
    Переопределения:
    
    getTimeZone в class Calendar
    
    Возвраты:
    
    объект часового пояса связался с этим календарем.
  - setTimeZone
```
public void setTimeZone(TimeZone zone)
```
    Описание скопировало с class: Calendar
    
    Устанавливает часовой пояс с данным значением часового пояса.
    
    Переопределения:
    
    setTimeZone в class Calendar
    
    Параметры:
    
    zone - данный часовой пояс.
  - isWeekDateSupported
```
public final boolean isWeekDateSupported()
```
    Возвраты true указание на это GregorianCalendar поддерживает недельные даты.
    
    Переопределения:
    
    isWeekDateSupported в class Calendar
    
    Возвраты:
    
    true (всегда)
    
    С тех пор:
    
    1.7
    
    См. Также:
    
    getWeekYear(), setWeekDate(int,int,int), getWeeksInWeekYear()
  - getWeekYear
```
public int getWeekYear()
```
    Возвращает недельный год, представленный этим GregorianCalendar. У дат в недели между 1 и максимальное недельное число недельного года есть то же самое недельное значение года, которое может быть за один год до этого или после YEAR (календарный год) значение.
    Это вызовы метода Calendar.complete() прежде, чем вычислить недельный год.
    
    Переопределения:
    
    getWeekYear в class Calendar
    
    Возвраты:
    
    недельный год представляется этим GregorianCalendar. Если ERA значение BC, год представляется 0 или отрицательное число: BC 1 0, BC 2-1, BC 3-2 и так далее.
    
    Броски:
    
    IllegalArgumentException - если какое-либо из календарных полей недопустимо в неснисходительном режиме.
    
    С тех пор:
    
    1.7
    
    См. Также:
    
    isWeekDateSupported(), getWeeksInWeekYear(), Calendar.getFirstDayOfWeek(), Calendar.getMinimalDaysInFirstWeek()
  - setWeekDate
```
public void setWeekDate(int weekYear,
                        int weekOfYear,
                        int dayOfWeek)
```
    Наборы это GregorianCalendar к дате, данной спецификаторами даты - weekYear, weekOfYear, и dayOfWeek. weekOfYear следует WEEK_OF_YEAR нумерация. dayOfWeek значение должно быть одним из DAY_OF_WEEK значения: SUNDAY к SATURDAY.
    Отметьте, что числовое дневное-недельного представление отличается от стандарта ISO 8601, и что weekOfYear нумерация является совместимой со стандартом когда getFirstDayOfWeek() MONDAY и getMinimalDaysInFirstWeek() 4.
    В отличие от этого set метод, все календарные поля и момент временной стоимости вычисляются на возврат.
    Если weekOfYear испытывает недостаток допустимого недельного-летнего диапазона в weekYear, weekYear и weekOfYear значения корректируются в снисходительном режиме, или IllegalArgumentException бросается в неснисходительный режим.
    
    Переопределения:
    
    setWeekDate в class Calendar
    
    Параметры:
    
    weekYear - недельный год
    
    weekOfYear - недельное число, основанное на weekYear
    
    dayOfWeek - день недельного значения: одна из констант для DAY_OF_WEEK поле: SUNDAY, ..., SATURDAY.
    
    Броски:
    
    IllegalArgumentException - если какой-либо из данных спецификаторов даты недопустим, или если какое-либо из календарных полей непоследовательно с данными спецификаторами даты в неснисходительном режиме
    
    С тех пор:
    
    1.7
    
    См. Также:
    
    isWeekDateSupported(), Calendar.getFirstDayOfWeek(), Calendar.getMinimalDaysInFirstWeek()
  - getWeeksInWeekYear
```
public int getWeeksInWeekYear()
```
    Возвращает число недель, в недельном году представленных этим GregorianCalendar.
    Например, если это GregorianCalendar's дата 31 декабря 2008 с ISO 8601 совместимая установка, этот метод возвратится 53 в течение периода: 29 декабря 2008 до 3 января 2010, в то время как getActualMaximum(WEEK_OF_YEAR) возвратится 52 в течение периода: 31 декабря 2007 до 28 декабря 2008.
    
    Переопределения:
    
    getWeeksInWeekYear в class Calendar
    
    Возвраты:
    
    число недель в недельном году.
    
    С тех пор:
    
    1.7
    
    См. Также:
    
    Calendar.WEEK_OF_YEAR, getWeekYear(), getActualMaximum(int)
  - computeFields
```
protected void computeFields()
```
    Преобразовывает временную стоимость (смещение миллисекунды от Эпохи) к календарным значениям полей. Время не повторно вычисляется сначала; повторно вычислить время, тогда поля, вызов complete метод.
    
    Определенный:
    
    computeFields в class Calendar
    
    См. Также:
    
    Calendar.complete()
  - computeTime
```
protected void computeTime()
```
    Преобразовывает календарные значения полей во временную стоимость (смещение миллисекунды от Эпохи).
    
    Определенный:
    
    computeTime в class Calendar
    
    Броски:
    
    IllegalArgumentException - если какие-либо календарные поля недопустимы.
    
    См. Также:
    
    Calendar.complete(), Calendar.computeFields()
  - toZonedDateTime
```
public ZonedDateTime toZonedDateTime()
```
    Преобразовывает этот объект в a ZonedDateTime это представляет ту же самую точку на временной шкале как это GregorianCalendar.
    Так как этот объект поддерживает Юлианско-грегорианскую cutover дату и ZonedDateTime не делает, возможно, что у получающегося года, месяца и дня будут различные значения. Результат представит корректную дату в календарной системе ISO, которая также будет тем же самым значением в течение Измененных Юлианских Дней.
    
    Возвраты:
    
    зонное разовое датой представление той же самой точки на временной шкале как этот григорианский календарь
    
    С тех пор:
    
    1.8
  - от
```
public static GregorianCalendar from(ZonedDateTime zdt)
```
    Получает экземпляр GregorianCalendar с локалью значения по умолчанию от a ZonedDateTime объект.
    С тех пор ZonedDateTime не поддерживает Юлианско-грегорианскую cutover дату и использует календарную систему ISO, возврат GregorianCalendar является чистым Григорианским календарем и использует стандарт ISO 8601 для недельных определений, который имеет MONDAY как FirstDayOfWeek и 4 как значение MinimalDaysInFirstWeek.
    ZoneDateTime может сохранить точки на временной шкале далее в будущем и далее в прошлом чем GregorianCalendar. В этом сценарии этот метод бросит IllegalArgumentException исключение.
    
    Параметры:
    
    zdt - зонный разовый датой объект преобразовать
    
    Возвраты:
    
    григорианский календарь, представляющий ту же самую точку на временной шкале как зонное обеспеченное разовое датой
    
    Броски:
    
    NullPointerException - если zdt нуль
    
    IllegalArgumentException - если зонное разовое датой является слишком большим, чтобы представить как a GregorianCalendar
    
    С тех пор:
    
    1.8

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс GregorianCalendar

Неделя Года Года и Недели

Неделя Месяца

Полевые Значения значения по умолчанию

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от class java.util. Календарь

Полевая Сводка

Поля, наследованные от class java.util. Календарь

Сводка конструктора

Сводка метода

Методы, наследованные от class java.util. Календарь

Методы, наследованные от class java.lang. Объект

Полевая Деталь

BC

AD

Деталь конструктора

GregorianCalendar

GregorianCalendar

GregorianCalendar

GregorianCalendar

GregorianCalendar

GregorianCalendar

GregorianCalendar

Деталь метода

setGregorianChange

getGregorianChange

isLeapYear

getCalendarType

равняется

хэш-код

добавить

рулон

рулон

getMinimum

getMaximum

getGreatestMinimum

getLeastMaximum

getActualMinimum

getActualMaximum

клон

getTimeZone

setTimeZone

isWeekDateSupported

getWeekYear

setWeekDate

getWeeksInWeekYear

computeFields

computeTime

toZonedDateTime

от