Spec-Zone.ru › OpenJDK 8

Класс 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, должны быть «нормализованы» путем установки часов, минут, секунд и миллисекунд в ноль в соответствующей часовой зоне, с которой связан экземпляр.

См. также:
Сериализованная форма

Конструкторы

Конструктор и описание
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()

Преобразует этот объект Date в LocalDate

String toString()

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

static Date valueOf(LocalDate date)

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

static Date valueOf(String s)

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

Методы, унаследованные от класса 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
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)

Преобразует строку в формате JDBC date escape в значение Date.

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

toString

public String toString()

Форматирует дату в формате date escape гггг-мм-дд.

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

getHours

@Deprecated
public int getHours()

Устаревшее.

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

Переопределяет:
getHours в классе Date
Возвращает:
час, представленный этой датой.
Исключения:
IllegalArgumentException - если этот метод вызван
См. также:
setHours(int)

getMinutes

@Deprecated
public int getMinutes()

Устаревшее.

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

Переопределяет:
getMinutes в классе Date
Возвращает:
количество минут после часа, представленного этой датой.
Исключения:
IllegalArgumentException - если этот метод вызван
См. также:
setMinutes(int)

getSeconds

@Deprecated
public int getSeconds()

Устаревшее.

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

Переопределяет:
getSeconds в классе Date
Возвращает:
количество секунд после минуты, представленной этой датой.
Исключения:
IllegalArgumentException - если этот метод вызван
См. также:
setSeconds(int)

setHours

@Deprecated
public void setHours(int i)

Устаревшее.

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

Переопределяет:
setHours в классе Date
Параметры:
i - значение часа.
Исключения:
IllegalArgumentException - если этот метод вызван
См. также:
getHours()

setMinutes

@Deprecated
public void setMinutes(int i)

Устаревшее.

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

Переопределяет:
setMinutes в классе Date
Параметры:
i - значение минут.
Исключения:
IllegalArgumentException - если этот метод вызван
См. также:
getMinutes()

setSeconds

@Deprecated
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()

Преобразует этот объект Date в LocalDate

Преобразование создаёт 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API