Классы Calendar и Date в Java
Попробуйте создать дату 15 февраля 2024 года старым способом: new Date(2024, 1, 15). Код скомпилируется (с предупреждением deprecation), но объект будет хранить 15 февраля 3924 года: конструктор ожидает не год, а смещение от 1900, а месяцы считает с нуля. Правильный вызов — new Date(124, 1, 15). В java.time та же дата записывается как LocalDate.of(2024, 2, 15) — и означает ровно то, что написано.

Классы Date и Calendar из пакета java.util — старый (legacy) API даты и времени Java. Date хранит момент времени как число миллисекунд от 1 января 1970 года 00:00:00 UTC, а Calendar раскладывает этот момент на год, месяц, день, часы и минуты и умеет их изменять. В новом коде вместо них используют Date-Time API (java.time), но Date и Calendar по-прежнему встречаются в старых проектах, JDBC и сторонних библиотеках — поэтому их особенности нужно знать.
1. Класс Date: момент времени в миллисекундах
Класс Date хранит одно значение типа long — количество миллисекунд, прошедших с 1970-01-01T00:00:00 UTC (эпоха Unix). Конструктор без параметров new Date() создаёт объект с текущим моментом, а метод getTime() возвращает это внутреннее число миллисекунд.
| Конструктор / метод | Что делает | Нюанс |
|---|---|---|
new Date() | Создаёт объект с текущим моментом | Точность — миллисекунды |
new Date(long ms) | Момент через ms миллисекунд после эпохи | Отрицательное значение — дата до 1970 года |
getTime() | Возвращает миллисекунды от эпохи | Для new Date() равно System.currentTimeMillis() |
setTime(long ms) | Меняет момент, хранящийся в объекте | Date изменяемый: изменение видно всем, у кого есть ссылка |
before(), after(), compareTo(), equals() | Сравнивают две даты | Сравнение идёт по миллисекундам, а не по календарным дням |
toInstant(), Date.from(Instant) | Мост к java.time (с Java 8) | У java.sql.Date метод toInstant() бросает UnsupportedOperationException |
Пример использования класса Date
import java.util.Date;
public class DateExample1 {
public static void main(String[] args) {
Date date1 = new Date();
System.out.println("Текущая дата: " + date1);
System.out.println("Количество мс: " + date1.getTime());
System.out.println();
Date date2 = new Date(12121212);
System.out.println("Установленная дата: " + date2);
date2.setTime(34343434);
System.out.println("Измененная дата: " + date2);
}
} Вывод при часовом поясе JVM UTC (первые две строки зависят от момента запуска — здесь 18 октября 2026 года, 12:00 UTC):
Текущая дата: Sun Oct 18 12:00:00 UTC 2026
Количество мс: 1792324800000
Установленная дата: Thu Jan 01 03:22:01 UTC 1970
Измененная дата: Thu Jan 01 09:32:23 UTC 1970 12 121 212 мс — это 3 часа 22 минуты 1,212 секунды после начала эпохи, 34 343 434 мс — 9 часов 32 минуты 23,434 секунды. Миллисекунды toString() не печатает.
Date не хранит часовой пояс
Внутри Date только миллисекунды от эпохи в UTC. Часовой пояс появляется лишь при печати: toString() берёт пояс JVM по умолчанию (TimeZone.getDefault()). Поэтому один и тот же объект new Date(12121212) в Москве напечатается как Thu Jan 01 06:22:01 MSK 1970, а на сервере в UTC — как 03:22:01 UTC. Для управляемого формата используйте SimpleDateFormat с явно заданным поясом.
2. Почему new Date(2024, 1, 15) — это 3924 год
Устаревший конструктор Date(int year, int month, int date) принимает год как смещение от 1900, а месяц — как число от 0 до 11. Поэтому new Date(2024, 1, 15) означает 1900 + 2024 = 3924 год, месяц 1 — февраль. День месяца при этом считается обычным образом, с единицы.
import java.time.LocalDate;
import java.util.Date;
public class DateYear1900 {
public static void main(String[] args) {
Date wrong = new Date(2024, 1, 15); // deprecated
System.out.println(wrong);
System.out.println(wrong.getYear()); // год минус 1900
Date right = new Date(124, 1, 15); // 124 = 2024 - 1900, 1 = февраль
System.out.println(right);
System.out.println(right.getYear() + " " + right.getMonth());
System.out.println(LocalDate.of(2024, 2, 15));
}
} Вывод (часовой пояс JVM — UTC):
Fri Feb 15 00:00:00 UTC 3924
2024
Thu Feb 15 00:00:00 UTC 2024
124 1
2024-02-15 Обратите внимание на вторую строку: getYear() для 3924 года возвращает 2024 — ошибку легко не заметить, если проверять только этот метод.
Откуда взялся 1900. Класс Date появился в Java 1.0 (1996) и скопировал соглашения структуры struct tm из стандартной библиотеки языка C: поле tm_year — число лет, прошедших с 1900, а tm_mon — число от 0 до 11, удобное как индекс в массиве названий месяцев. Отсюда getYear(), возвращающий год минус 1900 (2024 → 124), и getMonth() со значениями 0..11.
Уже в Java 1.1 эти конструкторы и методы (Date(int, int, int), getYear(), getMonth(), setHours() и другие) помечены @Deprecated в пользу Calendar. Но и в Calendar месяцы по-прежнему считаются с нуля: Calendar.JANUARY == 0. По-человечески — год как год, январь как 1 — это исправлено только в java.time (Java 8).
3. Класс Calendar и GregorianCalendar
Calendar — абстрактный класс, который переводит момент времени в миллисекундах в поля: год, месяц, день, час, минуты, секунды, номер недели. Объект получают через Calendar.getInstance() (текущий момент, пояс и локаль по умолчанию) или создают напрямую как GregorianCalendar.
GregorianCalendar — единственный публичный подкласс Calendar в java.util, но не единственный в JDK. Для локали th_TH метод Calendar.getInstance() вернёт sun.util.BuddhistCalendar (буддийский календарь, год больше на 543), а для ja_JP_JP — java.util.JapaneseImperialCalendar (летоисчисление по эрам императоров, класс пакетный). Поэтому код, который делает (GregorianCalendar) Calendar.getInstance(), на таких локалях упадёт с ClassCastException.
Пример: получение полей даты через get()
import java.util.Calendar;
public class CalendarExample2 {
public static void main(String[] args) {
Calendar calendar = Calendar.getInstance();
System.out.println("Месяц " + calendar.get(Calendar.MONTH));
System.out.println("Год " + calendar.get(Calendar.YEAR));
System.out.println("Неделя в месяце "
+ calendar.get(Calendar.WEEK_OF_MONTH));
System.out.println("Неделя в году "
+ calendar.get(Calendar.WEEK_OF_YEAR));
System.out.println("День в году " + calendar.get(Calendar.DAY_OF_YEAR));
System.out.println("День в месяце "
+ calendar.get(Calendar.DAY_OF_MONTH));
if (Calendar.MONDAY == calendar.getFirstDayOfWeek()) {
System.out.println("Первый день недели - Понедельник");
}
}
} Вывод при запуске 18 октября 2026 года с локалью ru_RU (результат зависит от текущей даты и локали):
Месяц 9
Год 2026
Неделя в месяце 3
Неделя в году 42
День в году 291
День в месяце 18
Первый день недели - Понедельник «Месяц 9» — это октябрь, а не сентябрь: Calendar.MONTH возвращает значения от 0 (январь) до 11 (декабрь). Чтобы получить привычный номер, прибавьте 1, а для сравнения используйте константы Calendar.OCTOBER и т.д.
Номера недель зависят от локали. В ru_RU неделя начинается с понедельника, а первой неделей года считается та, в которой не меньше 4 дней нового года (как в ISO 8601). В en_US неделя начинается с воскресенья и первой считается неделя с 1 января, поэтому для той же даты будет «Неделя в месяце 4», «Неделя в году 43», а строка про понедельник не выведется.
Как преобразовать Calendar в Date и обратно
Calendar и Date хранят один и тот же момент в миллисекундах, поэтому переход между ними — один вызов: calendar.getTime() возвращает Date, calendar.setTime(date) выставляет календарь на момент из Date, а calendar.getTimeInMillis() даёт то же число, что date.getTime().
import java.util.Calendar;
import java.util.Date;
import java.util.GregorianCalendar;
public class CalendarToDate {
public static void main(String[] args) {
Calendar calendar = new GregorianCalendar(2026, Calendar.OCTOBER, 18, 14, 30);
Date date = calendar.getTime(); // Calendar -> Date
long millis = calendar.getTimeInMillis(); // то же, что date.getTime()
Calendar other = Calendar.getInstance();
other.setTime(date); // Date -> Calendar
System.out.println(date);
System.out.println(millis == date.getTime());
System.out.println(other.get(Calendar.MONTH) + 1);
}
} Вывод (часовой пояс JVM — UTC):
Sun Oct 18 14:30:00 UTC 2026
true
10 getTime() возвращает новый объект Date: последующие изменения календаря через add() или set() на него не влияют, и наоборот.
4. Методы add() и roll(): как изменить дату
Метод add(field, amount) прибавляет к полю значение с переносом в старшие поля: 10 дней после 26 ноября дают 6 декабря. Метод roll(field, amount) прокручивает только указанное поле по кругу, не трогая месяц и год: те же 10 дней после 26 ноября дают 6 ноября.
import java.util.Calendar;
import java.util.GregorianCalendar;
public class CalendarExample1 {
public static void main(String[] args) {
// календарь на текущую дату
Calendar calendar1 = new GregorianCalendar();
System.out.println("Календарь на текущую дату: " + calendar1.getTime());
// календарь на 25.12.2013 (месяц с нуля: DECEMBER == 11)
Calendar calendar2 = new GregorianCalendar(2013, Calendar.DECEMBER, 25);
calendar2.add(Calendar.DAY_OF_YEAR, 1); // +1 день
System.out.println("Календарь на 26.12.2013: " + calendar2.getTime());
calendar2.add(Calendar.MONTH, -1); // -1 месяц
System.out.println("Календарь на 26.11.2013: " + calendar2.getTime());
calendar2.roll(Calendar.DAY_OF_MONTH, 10);
System.out.println("Календарь после roll: " + calendar2.getTime());
Calendar calendar3 = new GregorianCalendar(2013, Calendar.NOVEMBER, 26);
calendar3.add(Calendar.DAY_OF_MONTH, 10);
System.out.println("Календарь после add: " + calendar3.getTime());
}
} Вывод (часовой пояс JVM — UTC; первая строка зависит от момента запуска):
Календарь на текущую дату: Sun Oct 18 12:00:00 UTC 2026
Календарь на 26.12.2013: Thu Dec 26 00:00:00 UTC 2013
Календарь на 26.11.2013: Tue Nov 26 00:00:00 UTC 2013
Календарь после roll: Wed Nov 06 00:00:00 UTC 2013
Календарь после add: Fri Dec 06 00:00:00 UTC 2013 | Метод | Что делает | 26.11.2013 + 10 дней | Когда нужен |
|---|---|---|---|
add(DAY_OF_MONTH, 10) | Прибавляет с переносом в месяц и год | 06.12.2013 | Обычная арифметика дат: срок, дедлайн, «через неделю» |
roll(DAY_OF_MONTH, 10) | Прокручивает поле по кругу внутри его диапазона | 06.11.2013 | Редко: прокрутка значения в UI-виджете, где месяц меняться не должен |
set(DAY_OF_MONTH, 36) | Записывает значение; в нестрогом режиме нормализует при чтении | 06.12.2013 | Установка конкретного поля, а не сдвиг |
5. На чём чаще всего ошибаются
Большинство ошибок с Date и Calendar — не исключения, а тихо неверные даты: месяц на единицу больше, год на 1900 больше, 30 февраля, превратившееся в 2 марта. Компилятор их не ловит, поэтому полезно знать типичные промахи заранее.
| Ошибка | Что происходит | Как правильно |
|---|---|---|
new GregorianCalendar(2024, 3, 15) как «15 марта» | Получается 15 апреля: месяцы с нуля | Константы Calendar.MARCH или LocalDate.of(2024, 3, 15) |
new Date(2024, 1, 15) | 3924 год (смещение от 1900) | LocalDate.of(2024, 2, 15), при необходимости конвертировать в Date |
| Дата 30 февраля в Calendar | По умолчанию режим lenient: молча станет 2 марта | setLenient(false) — тогда getTime() бросит IllegalArgumentException |
set(Calendar.HOUR, 15) | HOUR — 12-часовой формат с AM_PM, 15 часов уйдут с переносом | Calendar.HOUR_OF_DAY для 0..23 |
Android: месяц из DatePickerDialog записан в дату как есть | В onDateSet(view, year, month, dayOfMonth) месяц приходит от 0 до 11 — дата сдвигается на месяц | Передавать month в Calendar.set() без изменений, а для LocalDate.of() — month + 1 |
| Общий Calendar или Date в нескольких потоках, возврат из геттера | Оба класса изменяемые и не потокобезопасные: чужой код может поменять дату | Копия (new Date(d.getTime()), calendar.clone()) или неизменяемые классы java.time |
java.sql.Date.toInstant() | UnsupportedOperationException: у SQL-даты нет времени | sqlDate.toLocalDate() |
Пример нестрогого и строгого режима:
import java.util.Calendar;
import java.util.GregorianCalendar;
public class LenientExample {
public static void main(String[] args) {
Calendar lenient = new GregorianCalendar(2023, Calendar.FEBRUARY, 30);
System.out.println(lenient.getTime());
Calendar strict = new GregorianCalendar();
strict.setLenient(false);
strict.clear();
strict.set(2023, Calendar.FEBRUARY, 30);
System.out.println(strict.getTime());
}
} Вывод (часовой пояс JVM — UTC):
Thu Mar 02 00:00:00 UTC 2023
Exception in thread "main" java.lang.IllegalArgumentException: ... В 2023 году в феврале 28 дней, поэтому «30 февраля» в нестрогом режиме превращается во 2 марта без всякого предупреждения. В java.time LocalDate.of(2023, 2, 30) сразу бросает DateTimeException.
6. Переход на java.time: конвертация Date и Calendar
С Java 8 Date и Calendar получили методы-мосты к java.time: Date.toInstant() и Date.from(Instant), GregorianCalendar.toZonedDateTime() и GregorianCalendar.from(ZonedDateTime). Для перехода к LocalDate нужен часовой пояс, потому что Date — момент времени, а LocalDate — календарный день без пояса.
import java.time.Instant;
import java.time.LocalDate;
import java.time.ZoneId;
import java.time.ZonedDateTime;
import java.util.Date;
import java.util.GregorianCalendar;
public class LegacyConversion {
public static void main(String[] args) {
ZoneId zone = ZoneId.systemDefault();
// Date <-> Instant
Date date = new Date();
Instant instant = date.toInstant();
Date fromInstant = Date.from(instant);
// Date <-> LocalDate (через часовой пояс)
LocalDate localDate = date.toInstant().atZone(zone).toLocalDate();
Date startOfDay = Date.from(localDate.atStartOfDay(zone).toInstant());
// GregorianCalendar <-> ZonedDateTime
GregorianCalendar calendar = new GregorianCalendar();
ZonedDateTime zdt = calendar.toZonedDateTime();
GregorianCalendar back = GregorianCalendar.from(zdt);
// java.sql.Date <-> LocalDate (toInstant() здесь не работает)
java.sql.Date sqlDate = java.sql.Date.valueOf(localDate);
LocalDate fromSql = sqlDate.toLocalDate();
}
} Обзор классов java.time, выбор между LocalDate, LocalDateTime, ZonedDateTime и Instant и пошаговая миграция со старого API разобраны в уроке Date-Time API в Java 8, а работа с датой без времени — в уроке Класс LocalDate.
Часто задаваемые вопросы
Чем класс Date отличается от Calendar в Java?
Date хранит один момент времени как число миллисекунд от 1 января 1970 года UTC и почти ничего не умеет. Calendar раскладывает этот момент на поля (год, месяц, день, час) с учётом часового пояса и локали и позволяет сдвигать дату методами add() и roll() — см. раздел о методах add() и roll().
Как преобразовать Calendar в Date и Date в Calendar?
Calendar в Date — calendar.getTime(), Date в Calendar — Calendar.getInstance() и затем calendar.setTime(date). Оба объекта хранят один и тот же момент в миллисекундах, поэтому при конвертации ничего не теряется — см. пример преобразования.
Устарел ли класс Date в Java?
Сам класс java.util.Date не помечен как deprecated, но устарели почти все конструкторы и методы, работающие с полями даты: Date(int, int, int), getYear(), getMonth(), setHours() и другие. Рабочими остаются new Date(), new Date(long), getTime(), setTime(), сравнение и toInstant(). В новом коде используйте java.time, а Date — только для совместимости со старыми API.
В чём разница между new Date().getTime() и System.currentTimeMillis()?
Обе записи возвращают одно и то же число — текущее время в миллисекундах от эпохи Unix. System.currentTimeMillis() не создаёт объект, поэтому для меток времени он проще. Для измерения длительности кода точнее System.nanoTime().
Как сравнить две даты типа Date?
Используйте before(), after() и compareTo() или сравните значения getTime(). Метод equals() возвращает true только при совпадении до миллисекунды, поэтому две даты одного дня с разным временем не равны. Чтобы сравнить только календарные дни, переведите Date в LocalDate — см. раздел о конвертации.
Читайте также: Использование класса SimpleDateFormat в языке Java, Класс DateFormat языка Java, Java курсы бесплатно, Java тесты онлайн.
Комментарии