Классы 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) — и означает ровно то, что написано.

Разница между java.util.date и java.time

Классы 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 тесты онлайн.