Класс 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 также предоставляет операции форматирования и разбора для поддержки синтаксиса SQL-экранирования для значений 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 до 999999999
Исключения:: 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 в формате 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()

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

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

toString в классе Date

Возвращает:

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

См. также:

getNanos

public int getNanos()

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

Возвращает:

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

См. также:

setNanos

public void setNanos(int n)

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

Параметры:

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 был добавлен для исправления неверного сигнатура Timestamp.equals(Timestamp) и сохранения обратной совместимости с существующими файлами классов. Примечание: Этот метод несимметричен относительно метода 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 позже заданного аргумента.
См. также:: Comparable
Since:: 1.4

compareTo

public int compareTo(Date o)

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

Определено в:: compareTo в интерфейсе Comparable<Date>
Переопределяет:: compareTo в классе Date
Параметры:: o - объект Date для сравнения с этим объектом Timestamp
Возвращает:: значение 0, если этот объект Timestamp и заданный объект равны; значение меньше, чем 0, если этот объект Timestamp раньше заданного аргумента; и значение больше, чем 0, если этот объект Timestamp позже заданного аргумента.
См. также:: Comparable
Since:: 1.5

hashCode

public int hashCode()

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


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

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

Overrides:

hashCode в классе Date

Returns:

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

See Also:

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, 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://download.java.net/java/early_access/jdk24/docs/api/java.sql/java/sql/Timestamp.html