Класс Timestamp
- Все реализуемые интерфейсы:
Serializable, Cloneable, Comparable<Date>
public class Timestamp extends Date
Тонкая оболочка вокруг java.util.Date, позволяющая API JDBC распознавать это значение как значение SQL TIMESTAMP. Она добавляет возможность хранить дробную часть секунд SQL TIMESTAMP, позволяя задавать дробные секунды с точностью до наносекунд. Timestamp также предоставляет операции форматирования и разбора для поддержки синтаксиса экранирования JDBC для значений отметки времени.
Точность объекта Timestamp вычисляется следующим образом:
-
19— число символов в yyyy-mm-dd hh:mm:ss -
20 + s— число символов в yyyy-mm-dd hh:mm:ss.[fff...], гдеsобозначает масштаб заданного Timestamp, то есть точность его дробной части секунд.
Примечание: Этот тип представляет собой комбинацию java.util.Date и отдельного значения наносекунд. В компоненте java.util.Date хранятся только целые секунды. Дробная часть секунд — наносекунды — хранится отдельно. Метод Timestamp.equals(Object) никогда не возвращает true, если ему передан объект, не являющийся экземпляром java.sql.Timestamp, поскольку компонент наносекунд для даты неизвестен. В результате метод Timestamp.equals(Object) не является симметричным относительно метода java.util.Date.equals(Object).
Из-за различий между классом Timestamp и упомянутым выше классом java.util.Date рекомендуется не рассматривать в коде значения Timestamp обобщённо как экземпляры java.util.Date. Отношение наследования между Timestamp и java.util.Date фактически обозначает наследование реализации, а не наследование типов.
- Начиная с:
- 1.1
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
Timestamp |
Устарел. |
Timestamp |
Создаёт объект Timestamp на основе значения времени в миллисекундах. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
after |
Показывает, следует ли этот объект Timestamp за заданным объектом Timestamp. |
boolean |
before |
Показывает, предшествует ли этот объект Timestamp заданному объекту Timestamp. |
int |
compareTo |
Сравнивает этот объект Timestamp с заданным объектом Timestamp. |
int |
compareTo |
Сравнивает этот объект Timestamp с заданным объектом Date. |
boolean |
equals |
Проверяет, равен ли этот объект Timestamp заданному объекту. |
boolean |
equals |
Проверяет, равен ли этот объект Timestamp заданному объекту Timestamp. |
static Timestamp |
from |
Создаёт экземпляр Timestamp на основе объекта Instant. |
int |
getNanos() |
Возвращает значение nanos этого объекта Timestamp. |
long |
getTime() |
Возвращает число миллисекунд с 1 января 1970 г., 00:00:00 по Гринвичу, представленное этим объектом Timestamp. |
int |
hashCode() |
Возвращает хеш-код этого объекта Timestamp. |
void |
setNanos |
Устанавливает для поля nanos этого объекта Timestamp заданное значение. |
void |
setTime |
Настраивает этот объект Timestamp для представления момента времени через time миллисекунд после 1 января 1970 г., 00:00:00 по Гринвичу. |
Instant |
toInstant() |
Преобразует этот объект Timestamp в Instant. |
LocalDateTime |
toLocalDateTime() |
Преобразует этот объект Timestamp в LocalDateTime. |
String |
toString() |
Форматирует отметку времени в формате экранирования JDBC для отметки времени. |
static Timestamp |
valueOf |
Преобразует объект String в формате экранирования JDBC для отметки времени в значение Timestamp. |
static Timestamp |
valueOf |
Создаёт экземпляр Timestamp на основе объекта LocalDateTime с теми же значениями даты и времени: годом, месяцем, днём месяца, часами, минутами, секундами и наносекундами, что и у переданного LocalDateTime. |
Методы, объявленные в классе Date
after, before, clone, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTimezoneOffset, getYear, parse, setDate, setHours, setMinutes, setMonth, setSeconds, setYear, toGMTString, toLocaleString, UTC | Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
after |
Проверяет, находится ли эта дата после указанной даты. |
boolean |
before |
Проверяет, находится ли эта дата перед указанной датой. |
Object |
clone() |
Возвращает копию этого объекта. |
int |
getDate() |
Устарел. Начиная с JDK 1.1 заменён на Calendar.get(Calendar.DAY_OF_MONTH). |
int |
getDay() |
Устарел. Начиная с JDK 1.1 заменён на Calendar.get(Calendar.DAY_OF_WEEK). |
int |
getHours() |
Устарел. Начиная с JDK 1.1 заменён на Calendar.get(Calendar.HOUR_OF_DAY). |
int |
getMinutes() |
Устарел. Начиная с JDK 1.1 заменён на Calendar.get(Calendar.MINUTE). |
int |
getMonth() |
Устарел. Начиная с JDK 1.1 заменён на Calendar.get(Calendar.MONTH). |
int |
getSeconds() |
Устарел. Начиная с JDK 1.1 заменён на Calendar.get(Calendar.SECOND). |
int |
getTimezoneOffset() |
Устарел. Начиная с JDK 1.1 заменён на -(Calendar.get(Calendar.ZONE_OFFSET) +
Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000). |
int |
getYear() |
Устарел. Начиная с JDK 1.1 заменён на Calendar.get(Calendar.YEAR) - 1900. |
static long |
parse |
Устарел. Начиная с JDK 1.1 заменён на DateFormat.parse(String s). |
void |
setDate |
Устарел. Начиная с JDK 1.1 заменён на Calendar.set(Calendar.DAY_OF_MONTH, int date). |
void |
setHours |
Устарел. Начиная с JDK 1.1 заменён на Calendar.set(Calendar.HOUR_OF_DAY, int hours). |
void |
setMinutes |
Устарел. Начиная с JDK 1.1 заменён на Calendar.set(Calendar.MINUTE, int minutes). |
void |
setMonth |
Устарел. Начиная с JDK 1.1 заменён на Calendar.set(Calendar.MONTH, int month). |
void |
setSeconds |
Устарел. Начиная с JDK 1.1 заменён на Calendar.set(Calendar.SECOND, int seconds). |
void |
setYear |
Устарел. Начиная с JDK 1.1 заменён на Calendar.set(Calendar.YEAR, year + 1900). |
String |
toGMTString() |
Устарел. Начиная с JDK 1.1 заменён на DateFormat.format(Date date) с использованием TimeZone по Гринвичу. |
String |
toLocaleString() |
Устарел. Начиная с JDK 1.1 заменён на DateFormat.format(Date date). |
static long |
UTC |
Устарел. Начиная с JDK 1.1 заменён на Calendar.set(year + 1900, month, date, hrs, min, sec) или GregorianCalendar(year + 1900, month, date, hrs, min, sec) с использованием TimeZone UTC, за которым следует Calendar.getTime().getTime(). |
Методы, объявленные в классе Object
finalize, getClass, notify, notifyAll, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected void |
finalize() |
Устарел, планируется удаление: этот элемент API будет удалён в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков. |
final Class |
getClass() |
Возвращает класс времени выполнения этого объекта Object. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
final void |
wait() |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного периода реального времени. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного периода реального времени. |
Подробное описание конструкторов
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 по Гринвичу. - См. также:
Подробное описание методов
setTime
getTime
valueOf
public static Timestamp valueOf(String s)
String в формате экранирования JDBC для отметки времени в значение Timestamp.- Параметры:
-
s— отметка времени в форматеyyyy-[m]m-[d]d hh:mm:ss[.f...]. Дробная часть секунд может отсутствовать. Начальный ноль вmmиddтакже может быть опущен. - Возвращает:
- соответствующее значение
Timestamp - Исключения:
-
IllegalArgumentException— если переданный аргумент не соответствует форматуyyyy-[m]m-[d]d hh:mm:ss[.f...]
toString
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) базового класса.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, возвращаемого методом getTime(). То есть хеш-код равен значению выражения: (int)(this.getTime()^(this.getTime() >>> 32))
valueOf
public static Timestamp valueOf(LocalDateTime dateTime)
Timestamp на основе объекта LocalDateTime с теми же значениями даты и времени: годом, месяцем, днём месяца, часами, минутами, секундами и наносекундами, что и у переданного LocalDateTime. Переданный объект LocalDateTime интерпретируется как локальные дата и время в местном часовом поясе.
- Параметры:
-
dateTime— объектLocalDateTimeдля преобразования - Возвращает:
- объект
Timestamp - Исключения:
-
NullPointerException— еслиdateTimeимеет значение null. - Начиная с:
- 1.8
toLocalDateTime
public LocalDateTime toLocalDateTime()
Timestamp в LocalDateTime. В результате преобразования создаётся объект LocalDateTime, представляющий те же значения даты и времени — год, месяц, день месяца, часы, минуты, секунды и наносекунды, — что и этот Timestamp в местном часовом поясе.
- Возвращает:
- объект
LocalDateTime, представляющий те же значения даты и времени - Начиная с:
- 1.8
from
public static Timestamp from(Instant instant)
Timestamp на основе объекта Instant. Instant может хранить точки на временной шкале, расположенные дальше в будущем и прошлом, чем Date. В этом случае данный метод выбрасывает исключение.
- Параметры:
-
instant— момент времени для преобразования - Возвращает:
- объект
Timestamp, представляющий ту же точку на временной шкале, что и переданный момент времени - Исключения:
-
NullPointerException— еслиinstantимеет значение null. -
IllegalArgumentException— если момент времени слишком велик, чтобы представить его в видеTimestamp - Начиная с:
- 1.8
toInstant
public Instant toInstant()
Timestamp в Instant. В результате преобразования создаётся объект Instant, представляющий ту же точку на временной шкале, что и этот Timestamp.
© 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.
Timestamp(long millis)