Класс 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