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