Spec-Zone.ru › OpenJDK 17

Класс 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 чч:мм:сс.[ммм...] и 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 GMT, представленных этим объектом Timestamp.
int hashCode()
Возвращает значение хэш-кода для этого объекта.
void setNanos(int n)
Устанавливает поле Timestamp этого объекта nanos в заданное значение.
void setTime(long time)
Устанавливает этот объект Timestamp для представления точки во времени, которая является time миллисекундами после 1 января 1970 года 00:00:00 GMT.
Instant toInstant()
Преобразует этот объект Timestamp в объект Instant.
LocalDateTime toLocalDateTime()
Преобразует этот объект Timestamp в LocalDateTime.
String toString()
Форматирует timestamp в формате timestamp escape JDBC.
static Timestamp valueOf(String s)
Преобразует объект String в формате escape timestamp JDBC в значение 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 по Гринвичу. Отрицательное число — это количество миллисекунд до 1 января 1970 г., 00:00:00 по Гринвичу.
См. также:
  • Calendar

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

setTime

public void setTime(long time)
Устанавливает этот объект Timestamp для представления момента времени, который находится на time миллисекунд после 1 января 1970 г. 00:00:00 по Гринвичу.
Переопределяет:
setTime в классе Date
Параметры:
time - количество миллисекунд.
См. также:
  • getTime()
  • Timestamp(long time)
  • Calendar

getTime

public long getTime()
Возвращает количество миллисекунд с 1 января 1970 г., 00:00:00 по Гринвичу, представленных этим объектом Timestamp.
Переопределяет:
getTime в классе Date
Возвращает:
количество миллисекунд с 1 января 1970 г., 00:00:00 по Гринвичу, представленных этой датой.
См. также:
  • setTime(long)

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
См. также:
  • Date.toLocaleString()
  • Date.toGMTString()

getNanos

public int getNanos()
Получает значение Timestamp объекта nanos.
Возвращает:
дробная часть секунды компонента объекта Timestamp
См. также:
  • setNanos(int)

setNanos

public void setNanos(int n)
Устанавливает поле Timestamp объекта nanos в заданное значение.
Параметры:
n - новая дробная часть секунды
Исключения:
IllegalArgumentException - если заданный аргумент больше 999999999 или меньше 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)
Получает экземпляр 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, 2021, 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/17/docs/api/java.sql/java/sql/Timestamp.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API