Класс Timestamp

public class Timestamp
extends Date

Тонкая оболочка вокруг java.util.Date, которая позволяет API JDBC идентифицировать это как значение SQL TIMESTAMP. Она добавляет возможность хранить значение дробных секунд SQL TIMESTAMP, разрешая указание дробных секунд с точностью до наносекунд. Класс Timestamp также предоставляет операции форматирования и парсинга для поддержки синтаксиса JDBC для значений timestamp.

Точность объекта Timestamp вычисляется как:

• 19 , что соответствует числу символов в yyyy-mm-dd чч:мм:сс
• 20 + s , что соответствует числу символов в yyyy-mm-dd чч:мм:сс.[fff...] и s представляет масштаб данного Timestamp, точность его дробных секунд.

Примечание: Этот тип является составным из java.util.Date и отдельного значения наносекунд. Только целые секунды хранятся в компоненте java.util.Date. Дробные секунды — наносекунды — хранятся отдельно. Метод Timestamp.equals(Object) никогда не возвращает true при передаче объекта, который не является экземпляром java.sql.Timestamp, потому что компонент наносекунд даты неизвестен. В результате метод Timestamp.equals(Object) не симметричен методу java.util.Date.equals(Object). Также метод hashCode использует реализацию java.util.Date и, следовательно, не включает наносекунды в свой расчет.

Из-за различий между классами Timestamp и java.util.Date, рекомендуем коду не рассматривать значения Timestamp как экземпляры java.util.Date. Взаимоотношение наследования между Timestamp и java.util.Date отражает наследование реализации, а не наследование типа.

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

Timestamp

@Deprecated
public Timestamp(int year,
                             int month,
                             int date,
                             int hour,
                             int minute,
                             int second,
                             int nano)

Устаревший. Вместо этого используйте конструктор Timestamp(long millis)

Создаёт объект Timestamp с заданными значениями.

Параметры:

year - год минус 1900

month - от 0 до 11

date - от 1 до 31

hour - от 0 до 23

minute - от 0 до 59

second - от 0 до 59

nano - от 0 до 999 999 999

Исключения:

IllegalArgumentException - если аргумент nano находится вне допустимого диапазона

Timestamp

public Timestamp(long time)

Создаёт объект Timestamp с использованием значения времени в миллисекундах. Целое число секунд хранится в базовом значении даты; дробная часть секунды хранится в поле nanos объекта Timestamp.

Параметры:

time - миллисекунды с момента 00:00:00 1 января 1970 года по Гринвичу. Отрицательное значение указывает на количество миллисекунд до 00:00:00 1 января 1970 года по Гринвичу.

См. также:

Calendar

Методы

setTime

public void setTime(long time)

Устанавливает этот объект Timestamp для представления момента времени, который находится на time миллисекунд после 00:00:00 1 января 1970 года по Гринвичу.

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

setTime в классе Date

Параметры:

time - количество миллисекунд.

См. также:

getTime(), Timestamp(long time), Calendar

getTime

public long getTime()

Возвращает количество миллисекунд с 00:00:00 1 января 1970 года по Гринвичу, представленное этим объектом Timestamp.

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

getTime в классе Date

Возвращает:

количество миллисекунд с 00:00:00 1 января 1970 года по Гринвичу, представленное этой датой.

См. также:

setTime(long)

valueOf

public static Timestamp valueOf(String s)

Преобразует объект String в формате JDBC timestamp escape в значение Timestamp.

Параметры:

s - timestamp в формате yyyy-[m]m-[d]d hh:mm:ss[.f...]. Дробная часть секунды может быть опущена. Ведущий ноль для mm и dd также может быть опущен.

Возвращает:

соответствующее значение Timestamp

Исключения:

IllegalArgumentException - если заданный аргумент не имеет формата yyyy-[m]m-[d]d hh:mm:ss[.f...]

toString

public String toString()

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

toString в классе Date

Возвращает:

объект String в формате yyyy-mm-dd hh:mm:ss.fffffffff

См. также:

Date.toLocaleString(), Date.toGMTString()

getNanos

public int getNanos()

Возвращает значение наносекунд этого объекта Timestamp.

Возвращает:

дробная часть секунды объекта Timestamp

См. также:

setNanos(int)

setNanos

public void setNanos(int n)

Устанавливает поле nanos этого объекта Timestamp в заданное значение.

Параметры:

n - новая дробная часть секунды

Исключения:

IllegalArgumentException - если заданный аргумент больше 999 999 999 или меньше 0

См. также:

getNanos()

equals

public boolean equals(Timestamp ts)

Проверяет, равен ли этот объект Timestamp заданному объекту Timestamp.

Параметры:

ts - сравниваемое значение Timestamp

Возвращает:

true если заданный объект Timestamp равен этому объекту Timestamp ; false в противном случае

equals

public boolean equals(Object ts)

Проверяет, равен ли этот объект Timestamp заданному объекту. Этот метод equals добавлен для исправления неверного подписи Timestamp.equals(Timestamp) и для сохранения обратной совместимости с существующими файлами классов. Примечание: Этот метод не симметричен по отношению к методу equals(Object) в базовом классе.

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

equals в классе Date

Параметры:

ts - сравниваемое значение Object

Возвращает:

true если заданный объект Object является экземпляром Timestamp , равным этому объекту Timestamp ; false в противном случае

См. также:

Date.getTime()

before

public boolean before(Timestamp ts)

Указывает, предшествует ли этот объект Timestamp заданному объекту Timestamp.

Параметры:

ts - сравниваемое значение Timestamp

Возвращает:

true если этот объект Timestamp предшествует; false в противном случае

after

public boolean after(Timestamp ts)

Указывает, следует ли этот объект Timestamp после заданного объекта Timestamp.

Параметры:

ts - сравниваемое значение Timestamp

Возвращает:

true если этот объект Timestamp следует; false в противном случае

compareTo

public int compareTo(Timestamp ts)

Сравнивает этот объект Timestamp с заданным объектом Timestamp.

Параметры:

ts - объект Timestamp для сравнения с этим объектом Timestamp

Возвращает:

значение 0 если два объекта Timestamp равны; значение меньше 0 если этот объект Timestamp предшествует заданному аргументу; и значение больше 0 если этот объект Timestamp следует за заданным аргументом.

С:

1.4

compareTo

public int compareTo(Date o)

Сравнивает этот объект Timestamp с заданным объектом Date.

Задано в:

compareTo в интерфейсе Comparable<Date>

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

compareTo в классе Date

Параметры:

o - объект Date для сравнения с этим объектом Timestamp

Возвращает:

значение 0 если этот объект Timestamp и заданный объект равны; значение меньше 0 если этот объект Timestamp предшествует заданному аргументу; и значение больше 0 если этот объект Timestamp следует за заданным аргументом.

С:

1.5

hashCode

public int hashCode()

Возвращает хэш-код для этого объекта. Результатом является исключающее ИЛИ двух половин примитивного значения long , возвращённого методом Date.getTime(). То есть, хэш-код - это значение выражения:

(int)(this.getTime()^(this.getTime() >>> 32))

Метод hashCode использует базовую реализацию java.util.Date и, следовательно, не включает наносекунды в своём вычислении.

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

hashCode в классе Date

Возвращает:

хэш-код для этого объекта.

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

valueOf

public static Timestamp valueOf(LocalDateTime dateTime)

Параметры:

dateTime - объект LocalDateTime для преобразования

Возвращает:

объект Timestamp

Исключения:

NullPointerException - если dateTime равен null.

С:

1.8

toLocalDateTime

public LocalDateTime toLocalDateTime()

Возвращает:

объект LocalDateTime , представляющий то же значение даты и времени

С:

1.8

from

public static Timestamp from(Instant instant)

Параметры:

instant - мгновение для преобразования

Возвращает:

объект Timestamp, представляющий ту же точку на временной шкале, что и предоставленное мгновение

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

NullPointerException - если instant равно null.

IllegalArgumentException - если мгновение слишком велико, чтобы быть представленным как Timesamp

С:

1.8

toInstant

public Instant toInstant()

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

toInstant в классе Date

Возвращает:

мгновение, представляющее ту же точку на временной шкале

С:

1.8