Класс 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 добавляет операции форматирования и разбора для поддержки синтаксиса escape-последовательностей 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()`	Форматирует время в формате escape-последовательности времени JDBC.
`static Time`	`valueOf(String s)`	Преобразует строку в формате escape-последовательности времени 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

Модификатор и тип	Метод	Описание
`boolean`	`after(Date when)`	Проверяет, находится ли эта дата после указанной даты.
`boolean`	`before(Date when)`	Проверяет, находится ли эта дата до указанной даты.
`Object`	`clone()`	Возвращает копию этого объекта.
`int`	`compareTo(Date anotherDate)`	Сравнивает две даты для определения порядка.
`boolean`	`equals(Object obj)`	Проверяет равенство двух дат.
`static Date`	`from(Instant instant)`	Получает экземпляр `Date` из объекта `Instant`.
`int`	`getHours()`	Устарел. Начиная с JDK 1.1 заменен на `Calendar.get(Calendar.HOUR_OF_DAY)`.
`int`	`getMinutes()`	Устарел. Начиная с JDK 1.1 заменен на `Calendar.get(Calendar.MINUTE)`.
`int`	`getSeconds()`	Устарел. Начиная с JDK 1.1 заменен на `Calendar.get(Calendar.SECOND)`.
`long`	`getTime()`	Возвращает количество миллисекунд, прошедших с 1 января 1970 года, 00:00:00 GMT, которое представляет этот объект `Date`.
`int`	`getTimezoneOffset()`	Устарел. Начиная с JDK 1.1 заменен на `-(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000)`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`static long`	`parse(String s)`	Устарел. Начиная с JDK 1.1 заменен на `DateFormat.parse(String s)`.
`void`	`setHours(int hours)`	Устарел. Начиная с JDK 1.1 заменен на `Calendar.set(Calendar.HOUR_OF_DAY, int hours)`.
`void`	`setMinutes(int minutes)`	Устарел. Начиная с JDK 1.1 заменен на `Calendar.set(Calendar.MINUTE, int minutes)`.
`void`	`setSeconds(int seconds)`	Устарел. Начиная с JDK 1.1 заменен на `Calendar.set(Calendar.SECOND, int seconds)`.
`String`	`toGMTString()`	Устарел. Начиная с JDK 1.1 заменен на `DateFormat.format(Date date)` с использованием `TimeZone` GMT.
`String`	`toLocaleString()`	Устарел. Начиная с JDK 1.1 заменен на `DateFormat.format(Date date)`.
`static long`	`UTC(int year, int month, int date, int hrs, int min, int sec)`	Устарел. Начиная с JDK 1.1 заменен на `Calendar.set(year + 1900, month, date, hrs, min, sec)` или `GregorianCalendar(year + 1900, month, date, hrs, min, sec)` с использованием `TimeZone` UTC, а затем на `Calendar.getTime().getTime()`.

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

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

Модификатор и тип	Метод	Описание
`protected void`	`finalize()`	Устарел, подлежит удалению: этот элемент API планируется удалить в будущей версии. Финализация устарела и планируется к удалению в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать до пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать до пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать до пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

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)

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

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

toString

public String toString()

Форматирует время в формате escape-последовательности времени 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.