Класс 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
Возвращает:
значение String в формате чч:мм:сс
См. также:
Date.toLocaleString(), Date.toGMTString()

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, 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/Time.html

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