Класс Time

java.lang.Object

java.util.Date

java.sql.Time

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

public class Time extends Date

Тонкая оболочка класса java.util.Date, которая позволяет API JDBC идентифицировать его как значение SQL TIME. Класс Time добавляет операции форматирования и парсинга для поддержки синтаксиса экранирования JDBC для значений времени.

Компоненты даты должны быть установлены в значение "нулевой эпохи" 1 января 1970 года и не должны использоваться.

С тех пор:

1.1

См. также:

Сериализованная форма

Краткое описание конструкторов

Конструктор	Описание
`Time(int hour, int minute, int second)`	Устаревший. Используйте конструктор, принимающий значение в миллисекундах, вместо этого конструктора
`Time(long time)`	Создает объект `Time` с использованием значения времени в миллисекундах.

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`getDate()`	Устаревший.
`int`	`getDay()`	Устаревший.
`int`	`getMonth()`	Устаревший.
`int`	`getYear()`	Устаревший.
`void`	`setDate(int i)`	Устаревший.
`void`	`setMonth(int i)`	Устаревший.
`void`	`setTime(long time)`	Устанавливает объект `Time` с использованием значения времени в миллисекундах.
`void`	`setYear(int i)`	Устаревший.
`Instant`	`toInstant()`	Этот метод всегда выбрасывает UnsupportedOperationException и не должен использоваться, потому что значения SQL `Time` не имеют компонента даты.
`LocalTime`	`toLocalTime()`	Преобразует этот объект `Time` в `LocalTime`.
`String`	`toString()`	Форматирует время в формате экранирования времени JDBC.
`static Time`	`valueOf(String s)`	Преобразует строку в формате экранирования времени JDBC в значение `Time`.
`static Time`	`valueOf(LocalTime time)`	Получает экземпляр `Time` из объекта `LocalTime` с одинаковым значением часа, минуты и секунды, что и у данного `LocalTime`.

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

after, before, clone, compareTo, equals, from, getHours, getMinutes, getSeconds, getTime, getTimezoneOffset, hashCode, parse, setHours, setMinutes, setSeconds, toGMTString, toLocaleString, UTC

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

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

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

Time

@Deprecated(since="1.2") public Time(int hour, int minute, int second)

Устарело.

Используйте конструктор, принимающий значение в миллисекундах, вместо этого конструктора

Создаёт объект Time, инициализированный заданными значениями часа, минуты и секунды. Драйвер устанавливает компоненты даты на 1 января 1970 года. Любой метод, который пытается получить доступ к компонентам даты объекта Time, вызовет исключение java.lang.IllegalArgumentException.

Результат неопределён, если заданный аргумент находится вне допустимого диапазона.

Параметры:: hour - от 0 до 23; minute - от 0 до 59; second - от 0 до 59

Time

public Time(long time)

Создаёт объект Time, используя значение времени в миллисекундах.

Параметры:: time - миллисекунды с момента 1 января 1970 года 00:00:00 GMT; отрицательное число соответствует миллисекундам до 1 января 1970 года 00:00:00 GMT

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

setTime

public void setTime(long time)

Устанавливает объект Time, используя значение времени в миллисекундах.

Переопределяет:: setTime в классе Date
Параметры:: time - миллисекунды с момента 1 января 1970 года 00:00:00 GMT; отрицательное число соответствует миллисекундам до 1 января 1970 года 00:00:00 GMT

valueOf

public static Time valueOf(String s)

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

Параметры:: s - время в формате "чч:мм:сс"
Возвращает:: соответствующий объект Time

toString

public String toString()

Форматирует время в формате JDBC time escape.

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

toString в классе Date

Возвращает:

время в формате чч:мм:сс

См. также:

getYear

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

Устарело.

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

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

getYear в классе Date

Возвращает:

год, представленный этой датой, минус 1900.

Инициирует:

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

См. также:

setYear(int)

getMonth

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

Устарело.

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

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

getMonth в классе Date

Возвращает:

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

Инициирует:

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

См. также:

setMonth(int)

getDay

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

Устарело.

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

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

getDay в классе Date

Возвращает:

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

Инициирует:

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

См. также:

Calendar

getDate

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

Устарело.

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

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

getDate в классе Date

Возвращает:

день месяца, представленный этой датой.

Инициирует:

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

См. также:

setDate(int)

setYear

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

Устарело.

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

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

setYear в классе Date

Параметры:

i - значение года.

Инициирует:

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

См. также:

getYear()

setMonth

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

Устарело.

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

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

setMonth в классе Date

Параметры:

i - значение месяца от 0 до 11.

Инициирует:

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

См. также:

getMonth()

setDate

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

Устарело.

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

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

setDate в классе Date

Параметры:

i - значение дня месяца от 1 до 31.

Инициирует:

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

См. также:

getDate()

valueOf

public static Time valueOf(LocalTime time)

Возвращает экземпляр Time из объекта LocalTime с тем же значением часа, минуты и секунды, что и у данного LocalTime. Поле наносекунд из LocalTime не является частью нового объекта Time.

Параметры:: time - объект LocalTime для преобразования
Возвращает:: объект Time
Инициирует:: NullPointerException - если time равно null
С:: 1.8

toLocalTime

public LocalTime toLocalTime()

Преобразует этот объект Time в объект LocalTime.

Преобразование создаёт объект LocalTime, представляющий то же значение часа, минуты и секунды, что и этот объект Time. Поле наносекунд LocalTime будет установлено в ноль.

Возвращает:: объект LocalTime представляющий то же значение времени
С:: 1.8

toInstant

public Instant toInstant()

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

Переопределяет:: 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/Time.html