Класс Date

java.lang.Object

java.util.Date

java.sql.Date

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

public class Date extends Date

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

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

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

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 - миллисекунды с момента 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()

Форматирует дату в формате yyyy-mm-dd.

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

toString в классе Date

Возвращает:

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

См. также:

getHours

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

Устарело.

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

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

getHours в классе Date

Возвращает:

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

Исключения:

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

См. также:

setHours(int)

getMinutes

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

Устарело.

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

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

getMinutes в классе Date

Возвращает:

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

Исключения:

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

См. также:

setMinutes(int)

getSeconds

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

Устарело.

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

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

getSeconds в классе Date

Возвращает:

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

Исключения:

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

См. также:

setSeconds(int)

setHours

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

Устарело.

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

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

setHours в классе Date

Параметры:

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

Исключения:

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

См. также:

getHours()

setMinutes

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

Устарело.

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

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

setMinutes в классе Date

Параметры:

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

Исключения:

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

См. также:

getMinutes()

setSeconds

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

Устарело.

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

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

setSeconds в классе Date

Параметры:

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

Исключения:

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

См. также:

getSeconds()

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, 2021, 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/17/docs/api/java.sql/java/sql/Date.html