Класс 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 января. Недели между первой неделей одного года и первой неделей следующего года (не включая последнюю) нумеруются последовательно от 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), то первая неделя 1998 года начинается 29 декабря 1997 года и заканчивается 4 января 1998 года. Для последних трёх дней календарного 1997 года неделей календарного года является 1998 год. Однако если getFirstDayOfWeek() равно SUNDAY, то первая неделя 1998 года начинается 4 января 1998 года и заканчивается 10 января 1998 года; тогда первые три дня 1998 года относятся к 53-й неделе 1997 года, а их неделя календарного года — 1997 год.

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

Значения, вычисляемые для поля WEEK_OF_MONTH, находятся в диапазоне от 0 до 6. Первая неделя месяца (дни со значением WEEK_OF_MONTH = 1) — это самый ранний набор как минимум из getMinimalDaysInFirstWeek() последовательных дней этого месяца, заканчивающийся накануне getFirstDayOfWeek(). В отличие от первой недели года, первая неделя месяца может быть короче 7 дней, не обязана начинаться в getFirstDayOfWeek() и не включает дни предыдущего месяца. Дни месяца, предшествующие первой неделе, имеют значение 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