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

В соответствии с определением 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

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

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

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

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, в которой выполняется приложение), соответствующее нулевому времени GMT.

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

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

setTime

public void setTime(long date)

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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.sql/java/sql/Date.html