Класс 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()

Форматирует дату в формате 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, выполняющей приложение), соответствующее нулю по Гринвичу.

Параметры:
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)

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

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

toString

public String toString()

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

Переопределяет:
toString в классе Date
Возвращает:
строку в формате yyyy-mm-dd
См. также:
Date.toLocaleString(), Date.toGMTString()

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

Spec-Zone .ru
спецификации, руководства, описания, API