Класс GregorianCalendar

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

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

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

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

Неделя года и год недели

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

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

Год недели совпадает с циклом 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 имеют значение WEEK_OF_MONTH 0.

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

Значения полей по умолчанию

Метод clear устанавливает значения календарных полей неопределёнными. GregorianCalendar использует следующие значения по умолчанию для каждого календарного поля, если его значение неопределённо.

Пример:

 // 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