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

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, Сериализированная Форма

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

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

Поля 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, MARCH, MAY, MILLISECOND, MINUTE, MONDAY, MONTH, NOVEMBER, OCTOBER, PM, SATURDAY, SECOND, SEPTEMBER, SHORT, SUNDAY, THURSDAY, time, TUESDAY, UNDECIMBER, WEDNESDAY, WEEK_OF_MONTH, WEEK_OF_YEAR, YEAR, ZONE_OFFSET

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

Конструкторы
Конструктор и Описание
`GregorianCalendar()` Создает значение по умолчанию `GregorianCalendar` использование текущего времени в часовом поясе по умолчанию с локалью по умолчанию.
`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` основанный на текущем времени в данном часовом поясе с локалью по умолчанию.
`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`.
`int`	`getActualMaximum(int field)` Возвращает максимальное значение, которое это календарное поле могло иметь, учитывая данную временную стоимость и текущую стоимость `getFirstDayOfWeek`, `getMinimalDaysInFirstWeek`, `getGregorianChange` и `getTimeZone` методы.
`int`	`getActualMinimum(int field)` Возвращает минимальное значение, которое это календарное поле могло иметь, учитывая данную временную стоимость и текущую стоимость `getFirstDayOfWeek`, `getMinimalDaysInFirstWeek`, `getGregorianChange` и `getTimeZone` методы.
`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`.

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

Методы 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 использование текущего времени в часовом поясе по умолчанию с локалью по умолчанию.
  - GregorianCalendar
```
public GregorianCalendar(TimeZone zone)
```
    Конструкции a GregorianCalendar основанный на текущем времени в данном часовом поясе с локалью по умолчанию.
    
    Параметры:
    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 иначе.
  - равняется
```
public boolean equals(Object obj)
```
    Сравнивает это GregorianCalendar к указанному Object. Результат true если и только если параметром является a GregorianCalendar объект, который представляет ту же самую временную стоимость (смещение миллисекунды от Эпохи) под тем же самым Calendar параметры и Грегорианская дата изменения как этот объект.
    
    Переопределения:
    
    equals в классе Calendar
    
    Параметры:
    obj - объект сравниться с.
    
    Возвраты:
    true если этот объект равен obj; false иначе.
    См. Также:
    Calendar.compareTo(Calendar)
  - хэш-код
```
public int hashCode()
```
    Генерирует хэш-код для этого GregorianCalendar объект.
    
    Переопределения:
    
    hashCode в классе 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 в классе 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 в классе 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 в классе 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 в классе 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 в классе 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 в классе 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 в классе 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 в классе 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 в классе Calendar
    
    Параметры:
    field - календарное поле
    
    Возвраты:
    максимум данного поля для временной стоимости этого GregorianCalendar
    С тех пор:
    
    1.2
    
    См. Также:
    getMinimum(int), getMaximum(int), getGreatestMinimum(int), getLeastMaximum(int), getActualMinimum(int)
  - клон
```
public Object clone()
```
    Описание скопировало с класса: Calendar
    
    Создает и возвращает копию этого объекта.
    
    Переопределения:
    
    clone в классе Calendar
    
    Возвраты:
    копия этого объекта.
    См. Также:
    Cloneable
  - getTimeZone
```
public TimeZone getTimeZone()
```
    Описание скопировало с класса: Calendar
    
    Получает часовой пояс.
    
    Переопределения:
    
    getTimeZone в классе Calendar
    
    Возвраты:
    объект часового пояса связался с этим календарем.
  - setTimeZone
```
public void setTimeZone(TimeZone zone)
```
    Описание скопировало с класса: Calendar
    
    Устанавливает часовой пояс с данным значением часового пояса.
    
    Переопределения:
    
    setTimeZone в классе Calendar
    
    Параметры:
    zone - данный часовой пояс.
  - isWeekDateSupported
```
public final boolean isWeekDateSupported()
```
    Возвраты true указание на это GregorianCalendar поддерживает недельные даты.
    
    Переопределения:
    
    isWeekDateSupported в классе Calendar
    
    Возвраты:
    true (всегда)
    С тех пор:
    
    1.7
    
    См. Также:
    getWeekYear(), setWeekDate(int,int,int), getWeeksInWeekYear()
  - getWeekYear
```
public int getWeekYear()
```
    Возвращает недельный год, представленный этим GregorianCalendar. У дат в недели между 1 и максимальное недельное число недельного года есть то же самое недельное значение года, которое может быть за один год до этого или после YEAR (календарный год) значение.
    Это вызовы метода Calendar.complete() прежде, чем вычислить недельный год.
    
    Переопределения:
    
    getWeekYear в классе 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 в классе 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 в классе Calendar
    
    Возвраты:
    число недель в недельном году.
    С тех пор:
    
    1.7
    
    См. Также:
    Calendar.WEEK_OF_YEAR, getWeekYear(), getActualMaximum(int)
  - computeFields
```
protected void computeFields()
```
    Преобразовывает временную стоимость (смещение миллисекунды от Эпохи) к календарным значениям полей. Время не повторно вычисляется сначала; повторно вычислить время, тогда поля, вызов complete метод.
    
    Определенный:
    
    computeFields в классе Calendar
    
    См. Также:
    Calendar.complete()
  - computeTime
```
protected void computeTime()
```
    Преобразовывает календарные значения полей во временную стоимость (смещение миллисекунды от Эпохи).
    
    Определенный:
    
    computeTime в классе Calendar
    
    Броски:
    
    IllegalArgumentException - если какие-либо календарные поля недопустимы.
    См. Также:
    Calendar.complete(), Calendar.computeFields()

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

Класс GregorianCalendar

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

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

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

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

Поля java.util унаследованный от класса. Календарь

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

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

Методы java.util унаследованный от класса. Календарь

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

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

BC

AD

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

GregorianCalendar

GregorianCalendar

GregorianCalendar

GregorianCalendar

GregorianCalendar

GregorianCalendar

GregorianCalendar

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

setGregorianChange

getGregorianChange

isLeapYear

равняется

хэш-код

добавить

рулон

рулон

getMinimum

getMaximum

getGreatestMinimum

getLeastMaximum

getActualMinimum

getActualMaximum

клон

getTimeZone

setTimeZone

isWeekDateSupported

getWeekYear

setWeekDate

getWeeksInWeekYear

computeFields

computeTime