Класс 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`.

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

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

Методы, объявленные в классе 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.

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

toString

public String toString()

Форматирует время в формате экранирования времени JDBC.

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

toString в классе Date

Возвращает:

значение String в формате hh:mm:ss

См. также:

getYear

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

Устарело.

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

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

getYear в классе Date

Возвращает:

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

Выбрасывает:

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

См. также:

getMonth

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

Устарело.

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

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

getMonth в классе Date

Возвращает:

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

Выбрасывает:

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

См. также:

getDay

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

Устарело.

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

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

getDay в классе Date

Возвращает:

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

Выбрасывает:

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

См. также:

getDate

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

Устарело.

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

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

getDate в классе Date

Возвращает:

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

Выбрасывает:

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

См. также:

setYear

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

Устарело.

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

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

setYear в классе Date

Параметры:

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

Выбрасывает:

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

См. также:

setMonth

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

Устарело.

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

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

setMonth в классе Date

Параметры:

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

Выбрасывает:

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

См. также:

setDate

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

Устарело.

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

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

setDate в классе Date

Параметры:

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

Выбрасывает:

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

См. также:

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, 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://docs.oracle.com/en/java/javase/25/docs/api/java.sql/java/sql/Time.html