Класс Date

java.lang.Object

java.util.Date

java.sql.Date

Все реализуемые интерфейсы:: Serializable, Cloneable, Comparable<Date>

public class Date extends Date

Тонкая оболочка для значения в миллисекундах, которая позволяет JDBC распознавать его как значение SQL DATE. Значение в миллисекундах представляет количество миллисекунд, прошедших с 1 января 1970 г. 00:00:00.000 по Гринвичу.

В соответствии с определением SQL DATE значения миллисекунд, обернутые экземпляром java.sql.Date, должны быть «нормализованы»: часы, минуты, секунды и миллисекунды обнуляются в конкретном часовом поясе, с которым связан экземпляр.

Начиная с:

1.1

См. также:

Краткое описание конструкторов

Конструктор	Описание
`Date(int year, int month, int day)`	Устарело. вместо него используйте конструктор `Date(long date)`
`Date(long date)`	Создает объект `Date`, используя заданное значение времени в миллисекундах.

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`getHours()`	Устарело.
`int`	`getMinutes()`	Устарело.
`int`	`getSeconds()`	Устарело.
`void`	`setHours(int i)`	Устарело.
`void`	`setMinutes(int i)`	Устарело.
`void`	`setSeconds(int i)`	Устарело.
`void`	`setTime(long date)`	Устанавливает существующий объект `Date`, используя заданное значение времени в миллисекундах.
`Instant`	`toInstant()`	Этот метод всегда выбрасывает UnsupportedOperationException и не должен использоваться, поскольку значения SQL `Date` не содержат компонента времени.
`LocalDate`	`toLocalDate()`	Создает экземпляр `LocalDate`, используя год, месяц и день из этого объекта `Date`.
`String`	`toString()`	Форматирует дату в формате escape-последовательности даты: yyyy-mm-dd.
`static Date`	`valueOf(String s)`	Преобразует строку в формате escape-последовательности даты JDBC в значение `Date`.
`static Date`	`valueOf(LocalDate date)`	Получает экземпляр `Date` из объекта `LocalDate` с теми же значениями года, месяца и дня месяца, что и у заданного `LocalDate`.

Методы, объявленные в классе Date

after, before, clone, compareTo, equals, from, getDate, getDay, getMonth, getTime, getTimezoneOffset, getYear, hashCode, parse, setDate, setMonth, setYear, toGMTString, toLocaleString, UTC

Модификатор и тип	Метод	Описание
`boolean`	`after(Date when)`	Проверяет, находится ли эта дата после указанной даты.
`boolean`	`before(Date when)`	Проверяет, находится ли эта дата до указанной даты.
`Object`	`clone()`	Возвращает копию этого объекта.
`int`	`compareTo(Date anotherDate)`	Сравнивает две даты для определения порядка.
`boolean`	`equals(Object obj)`	Сравнивает две даты на равенство.
`static Date`	`from(Instant instant)`	Получает экземпляр `Date` из объекта `Instant`.
`int`	`getDate()`	Устарело. Начиная с версии JDK 1.1 заменено на `Calendar.get(Calendar.DAY_OF_MONTH)`.
`int`	`getDay()`	Устарело. Начиная с версии JDK 1.1 заменено на `Calendar.get(Calendar.DAY_OF_WEEK)`.
`int`	`getMonth()`	Устарело. Начиная с версии JDK 1.1 заменено на `Calendar.get(Calendar.MONTH)`.
`long`	`getTime()`	Возвращает количество миллисекунд, прошедших с 1 января 1970 г. 00:00:00 по Гринвичу, представленное этим объектом `Date`.
`int`	`getTimezoneOffset()`	Устарело. Начиная с версии JDK 1.1 заменено на `-(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000)`.
`int`	`getYear()`	Устарело. Начиная с версии JDK 1.1 заменено на `Calendar.get(Calendar.YEAR) - 1900`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`static long`	`parse(String s)`	Устарело. Начиная с версии JDK 1.1 заменено на `DateFormat.parse(String s)`.
`void`	`setDate(int date)`	Устарело. Начиная с версии JDK 1.1 заменено на `Calendar.set(Calendar.DAY_OF_MONTH, int date)`.
`void`	`setMonth(int month)`	Устарело. Начиная с версии JDK 1.1 заменено на `Calendar.set(Calendar.MONTH, int month)`.
`void`	`setYear(int year)`	Устарело. Начиная с версии JDK 1.1 заменено на `Calendar.set(Calendar.YEAR, year + 1900)`.
`String`	`toGMTString()`	Устарело. Начиная с версии JDK 1.1 заменено на `DateFormat.format(Date date)` с использованием `TimeZone` по Гринвичу.
`String`	`toLocaleString()`	Устарело. Начиная с версии JDK 1.1 заменено на `DateFormat.format(Date date)`.
`static long`	`UTC(int year, int month, int date, int hrs, int min, int sec)`	Устарело. Начиная с версии JDK 1.1 заменено на `Calendar.set(year + 1900, month, date, hrs, min, sec)` или `GregorianCalendar(year + 1900, month, date, hrs, min, sec)` с использованием `TimeZone` UTC, а затем `Calendar.getTime().getTime()`.

Методы, объявленные в классе Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`final void`	`notify()`	Будит один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Будит все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного периода реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного периода реального времени.

Подробное описание конструкторов

Date

@Deprecated(since="1.2") public Date(int year, int month, int day)

Устарело.

вместо него используйте конструктор Date(long date)

Создает объект Date, инициализированный заданными годом, месяцем и днем.

Результат не определен, если какой-либо аргумент выходит за допустимые границы.

Параметры:: year — год минус 1900; должен быть от 0 до 8099. (Обратите внимание, что 8099 — это 9999 минус 1900.); month — от 0 до 11; day — от 1 до 31

Date

public Date(long date)

Создает объект Date, используя заданное значение времени в миллисекундах. Если заданное значение в миллисекундах содержит сведения о времени, драйвер установит компоненты времени в соответствии со временем в часовом поясе по умолчанию (часовом поясе виртуальной машины Java, в которой выполняется приложение), соответствующим нулевому времени по Гринвичу.

Параметры:: date — количество миллисекунд, прошедших с 1 января 1970 г. 00:00:00 по Гринвичу; значение не должно превышать представление в миллисекундах для 8099 года. Отрицательное число указывает количество миллисекунд до 1 января 1970 г. 00:00:00 по Гринвичу.

Подробное описание методов

setTime

public void setTime(long date)

Устанавливает значение существующего объекта Date, используя заданное значение времени в миллисекундах. Если заданное значение в миллисекундах содержит сведения о времени, драйвер установит компоненты времени в соответствии со временем в часовом поясе по умолчанию (часовом поясе виртуальной машины Java, в которой выполняется приложение), соответствующим нулевому времени по Гринвичу.

Переопределяет:: setTime в классе Date
Параметры:: date — количество миллисекунд, прошедших с 1 января 1970 г. 00:00:00 по Гринвичу; значение не должно превышать представление в миллисекундах для 8099 года. Отрицательное число указывает количество миллисекунд до 1 января 1970 г. 00:00:00 по Гринвичу.

valueOf

public static Date valueOf(String s)

Преобразует строку в формате escape-последовательности даты JDBC в значение Date.

Параметры:: s — объект String, представляющий дату в формате «yyyy-[m]m-[d]d». Начальный ноль в mm и dd также можно опустить.
Возвращает:: объект java.sql.Date, представляющий заданную дату
Вызывает исключение:: IllegalArgumentException — если дата задана не в формате escape-последовательности даты JDBC (yyyy-[m]m-[d]d)

toString

public String toString()

Форматирует дату в формате escape-последовательности даты yyyy-mm-dd.

Переопределяет:

toString в классе Date

Возвращает:

строку в формате yyyy-mm-dd

См. также:

getHours

@Deprecated(since="1.2") public int getHours()

Устарело.

Этот метод устарел и не должен использоваться, поскольку значения SQL Date не содержат компонента времени.

Переопределяет:

getHours в классе Date

Возвращает:

час, представленный этой датой.

Вызывает исключение:

IllegalArgumentException — если вызван этот метод

См. также:

getMinutes

@Deprecated(since="1.2") public int getMinutes()

Устарело.

Этот метод устарел и не должен использоваться, поскольку значения SQL Date не содержат компонента времени.

Переопределяет:

getMinutes в классе Date

Возвращает:

количество минут, прошедших с начала часа, представленного этой датой.

Вызывает исключение:

IllegalArgumentException — если вызван этот метод

См. также:

getSeconds

@Deprecated(since="1.2") public int getSeconds()

Устарело.

Этот метод устарел и не должен использоваться, поскольку значения SQL Date не содержат компонента времени.

Переопределяет:

getSeconds в классе Date

Возвращает:

количество секунд, прошедших с начала минуты, представленной этой датой.

Вызывает исключение:

IllegalArgumentException — если вызван этот метод

См. также:

setHours

@Deprecated(since="1.2") public void setHours(int i)

Устарело.

Этот метод устарел и не должен использоваться, поскольку значения SQL Date не содержат компонента времени.

Переопределяет:

setHours в классе Date

Параметры:

i — значение часа.

Вызывает исключение:

IllegalArgumentException — если вызван этот метод

См. также:

setMinutes

@Deprecated(since="1.2") public void setMinutes(int i)

Устарело.

Этот метод устарел и не должен использоваться, поскольку значения SQL Date не содержат компонента времени.

Переопределяет:

setMinutes в классе Date

Параметры:

i — значение минут.

Вызывает исключение:

IllegalArgumentException — если вызван этот метод

См. также:

setSeconds

@Deprecated(since="1.2") public void setSeconds(int i)

Устарело.

Этот метод устарел и не должен использоваться, поскольку значения SQL Date не содержат компонента времени.

Переопределяет:

setSeconds в классе Date

Параметры:

i — значение секунд.

Вызывает исключение:

IllegalArgumentException — если вызван этот метод

См. также:

valueOf

public static Date valueOf(LocalDate date)

Получает экземпляр Date из объекта LocalDate с теми же значениями года, месяца и дня месяца, что и у заданного LocalDate.

Предоставленный LocalDate интерпретируется как местная дата в местном часовом поясе.

Параметры:: date — LocalDate для преобразования
Возвращает:: объект Date
Вызывает исключение:: NullPointerException — если date равен null
Начиная с:: 1.8

toLocalDate

public LocalDate toLocalDate()

Создает экземпляр LocalDate, используя год, месяц и день из этого объекта Date.

Возвращает:: объект LocalDate, представляющий то же значение даты
Начиная с:: 1.8

toInstant

public Instant toInstant()

Этот метод всегда выбрасывает UnsupportedOperationException и не должен использоваться, поскольку значения SQL Date не содержат компонента времени.

Переопределяет:: toInstant в классе Date
Возвращает:: момент времени, соответствующий той же точке временной шкалы, что и этот объект Date
Вызывает исключение:: UnsupportedOperationException — если вызван этот метод

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.