Класс 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()`	Форматирует дату в формате даты yyyy-mm-dd.
`static Date`	`valueOf(String s)`	Преобразует строку в формате JDBC даты в значение `Date`.
`static Date`	`valueOf(LocalDate date)`	Получает экземпляр `Date` из объекта `LocalDate` с тем же годом, месяцем и днем месяца, что и у данного `LocalDate`.

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

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

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

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

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

Дата

@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

Дата

public Date(long date)

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

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

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

setTime

public void setTime(long date)

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

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

valueOf

public static Date valueOf(String s)

Преобразует строку в формате экранирования даты JDBC в значение Date.

Параметры:: s - объект String, представляющий дату в формате "гггг-[мм]-[дд]". Ведущий ноль для mm и dd также может быть опущен.
Возвращает:: объект java.sql.Date, представляющий заданную дату
Исключения:: IllegalArgumentException - если заданная дата не соответствует формату экранирования даты JDBC (гггг-[мм]-[дд])

toString

public String toString()

Форматирует дату в формате экранирования даты гггг-мм-дд.

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

toString в классе Date

Возвращает:

строку в формате гггг-мм-дд

См. также:

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://download.java.net/java/early_access/jdk24/docs/api/java.sql/java/sql/Date.html