Класс Timestamp

java.lang.Object

java.util.Date

java.sql.Timestamp

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

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 на самом деле обозначает наследование реализации, а не наследование типа.

С:

1.1

См. также:

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

Конструктор	Описание
`Timestamp(int year, int month, int date, int hour, int minute, int second, int nano)`	Устаревший. Вместо этого используйте конструктор `Timestamp(long millis)`
`Timestamp(long time)`	Создаёт объект `Timestamp`, используя значение времени в миллисекундах.

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

Модификатор и тип	Метод	Описание
`boolean`	`after(Timestamp ts)`	Указывает, является ли этот объект `Timestamp` позже, чем указанный объект `Timestamp`.
`boolean`	`before(Timestamp ts)`	Указывает, является ли этот объект `Timestamp` раньше, чем указанный объект `Timestamp`.
`int`	`compareTo(Timestamp ts)`	Сравнивает этот объект `Timestamp` с заданным объектом `Timestamp`.
`int`	`compareTo(Date o)`	Сравнивает этот объект `Timestamp` с заданным объектом `Date`.
`boolean`	`equals(Object ts)`	Проверяет, равен ли этот объект `Timestamp` заданному объекту.
`boolean`	`equals(Timestamp ts)`	Проверяет, равен ли этот объект `Timestamp` заданному объекту `Timestamp`.
`static Timestamp`	`from(Instant instant)`	Получает экземпляр `Timestamp` из объекта `Instant`.
`int`	`getNanos()`	Получает значение `Timestamp` этого объекта `nanos`.
`long`	`getTime()`	Возвращает количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по Гринвичу, представленное этим объектом `Timestamp`.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого объекта.
`void`	`setNanos(int n)`	Устанавливает поле `Timestamp` этого объекта `nanos` в заданное значение.
`void`	`setTime(long time)`	Устанавливает этот объект `Timestamp` для представления момента времени, который `time` миллисекунд после 1 января 1970 г. 00:00:00 по Гринвичу.
`Instant`	`toInstant()`	Преобразует этот объект `Timestamp` в `Instant`.
`LocalDateTime`	`toLocalDateTime()`	Преобразует этот объект `Timestamp` в `LocalDateTime`.
`String`	`toString()`	Форматирует timestamp в формате JDBC timestamp escape.
`static Timestamp`	`valueOf(String s)`	Преобразует объект `String` в формате JDBC timestamp escape в значение `Timestamp`.
`static Timestamp`	`valueOf(LocalDateTime dateTime)`	Получает экземпляр `Timestamp` из объекта `LocalDateTime`, с тем же годом, месяцем, числом месяца, часами, минутами, секундами и наносекундами, что и предоставленный объект `LocalDateTime`.

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

after, before, clone, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTimezoneOffset, getYear, parse, setDate, setHours, setMinutes, setMonth, setSeconds, setYear, toGMTString, toLocaleString, UTC

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

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

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

Timestamp

@Deprecated(since="1.2") 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 - миллисекунды с момента 1 января 1970 года, 00:00:00 GMT. Отрицательное значение — число миллисекунд до 1 января 1970 года, 00:00:00 GMT.

См. также:

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

setTime

public void setTime(long time)

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

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

setTime в классе Date

Параметры:

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

См. также:

getTime

public long getTime()

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

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

getTime в классе Date

Возвращает:

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

См. также:

valueOf

public static Timestamp valueOf(String s)

Преобразует объект String в формате escape JDBC timestamp в значение 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()

Форматирует timestamp в формате escape JDBC timestamp. yyyy-mm-dd hh:mm:ss.fffffffff, где fffffffff обозначает наносекунды.

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

toString в классе Date

Возвращает:

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

См. также:

getNanos

public int getNanos()

Получает значение Timestamp объекта nanos.

Возвращает:

компонент дробных секунд объекта Timestamp

См. также:

setNanos

public void setNanos(int n)

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

Параметры:

n - новый компонент дробных секунд

Исключения:

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

См. также:

equals

public boolean equals(Timestamp ts)

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

Параметры:: ts - значение Timestamp для сравнения
Возвращает:: true если заданный объект Timestamp равен этому объекту Timestamp; false в противном случае

equals

public boolean equals(Object ts)

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

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

equals в классе Date

Параметры:

ts - значение Object для сравнения

Возвращает:

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

См. также:

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

Возвращает:

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

См. также:

valueOf

public static Timestamp valueOf(LocalDateTime dateTime)

Получает экземпляр Timestamp из объекта LocalDateTime, с тем же годом, месяцем, днем месяца, часами, минутами, секундами и наносекундами, что и предоставленный LocalDateTime.

Предоставленный LocalDateTime интерпретируется как локальное время в местном часовом поясе.

Parameters:: dateTime - преобразуемый LocalDateTime
Returns:: объект Timestamp
Throws:: NullPointerException - если dateTime равен null.
Since:: 1.8

toLocalDateTime

public LocalDateTime toLocalDateTime()

Преобразует этот объект Timestamp в LocalDateTime.

Преобразование создаёт LocalDateTime, который представляет ту же дату и время (год, месяц, день месяца, часы, минуты, секунды и наносекунды), что и этот объект Timestamp в местном часовом поясе.

Returns:: объект LocalDateTime , представляющий ту же дату и время
Since:: 1.8

from

public static Timestamp from(Instant instant)

Получает экземпляр Timestamp из объекта Instant.

Instant может хранить моменты времени, которые находятся дальше в будущем и дальше в прошлом, чем Date. В этом случае этот метод выбросит исключение.

Parameters:: instant - преобразуемый момент времени
Returns:: объект Timestamp, представляющий тот же момент времени, что и предоставленный момент
Throws:: NullPointerException - если instant равен null.; IllegalArgumentException - если момент времени слишком велик для представления как Timestamp
Since:: 1.8

toInstant

public Instant toInstant()

Преобразует этот объект Timestamp в Instant.

Преобразование создаёт Instant, который представляет тот же момент времени, что и этот объект Timestamp.

Overrides:: toInstant в классе Date
Returns:: момент времени, представляющий тот же момент времени
Since:: 1.8

© 1993, 2023, 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/21/docs/api/java.sql/java/sql/Timestamp.html