Метка времени (Платформа Java SE 8 b92)

java.lang. Объект
- java.util. Дата
- - java.sql. Метка времени

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable, Сопоставимый <Дата>
```
public class Timestamp
extends Date
```
Тонкая обертка вокруг java.util.Date это позволяет API JDBC идентифицировать это как SQL TIMESTAMP значение. Это добавляет возможность содержать SQL TIMESTAMP значение долей секунды, позволяя спецификацию долей секунды к точности наносекунд. Метка времени также обеспечивает форматирование и парсинг операций, чтобы поддерживать синтаксис escape JDBC для значений метки времени.
Точность объекта Метки времени вычисляется, чтобы быть также:
- 19 , который является числом символов в yyyy-mm-dd hh:mm:ss
- 20 + s , который является числом символов в yyyy-mm-dd hh:mm:ss. [fff...] и s представляет масштаб данной Метки времени, ее точности долей секунды.
Отметьте: Этот тип является составным объектом a java.util.Date и отдельное значение наносекунд. Только интегральные секунды сохранены в java.util.Date компонент. Доли секунды - nanos - являются отдельными. Timestamp.equals(Object) метод никогда не возвращается true когда передано объект, который не является экземпляром java.sql.Timestamp, потому что nanos компонент даты неизвестен. В результате Timestamp.equals(Object) метод не симметричен относительно java.util.Date.equals(Object) метод. Кроме того, hashCode метод использует базовое java.util.Date реализация и поэтому не включает nanos в свое вычисление.
Из-за различий между Timestamp class и java.util.Date Упомянутый выше class, рекомендуется, чтобы тот код не просмотрел Timestamp значения в общем как экземпляр java.util.Date. Отношение наследования между Timestamp и java.util.Date действительно обозначает наследование реализации, и не наследование типа.
См. Также:

Сериализированная Форма

Сводка конструктора

Конструкторы
Конструктор и Описание
`Timestamp(int year, int month, int date, int hour, int minute, int second, int nano)` Осуждаемый. вместо этого используйте конструктора `Timestamp(long millis)`
`Timestamp(long time)` Конструкции a `Timestamp` объект используя временную стоимость миллисекунд.

Сводка метода

Все Методы Статические Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`boolean`	`after(Timestamp ts)` Указывает ли это `Timestamp` объект позже чем данный `Timestamp` объект.
`boolean`	`before(Timestamp ts)` Указывает ли это `Timestamp` объект ранее чем данный `Timestamp` объект.
`int`	`compareTo(Date o)` Сравнивает это `Timestamp` возразите против данного `Date` объект.
`int`	`compareTo(Timestamp ts)` Сравнивает это `Timestamp` возразите против данного `Timestamp` объект.
`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, GMT 0:00:00, представленный этим `Timestamp` объект.
`int`	`hashCode()` Возвращает значение хэш-кода для этого объекта.
`void`	`setNanos(int n)` Наборы это `Timestamp` объект `nanos` поле к данному значению.
`void`	`setTime(long time)` Наборы это `Timestamp` объект представить момент времени, который является миллисекундами `time` после 1 января 1970 GMT 0:00:00.
`Момент`	`toInstant()` Преобразовывает это `Timestamp` возразите против `Instant`.
`LocalDateTime`	`toLocalDateTime()` Преобразовывает это `Timestamp` возразите против a `LocalDateTime`.
`Строка`	`toString()` Форматирует метку времени в формате escape метки времени JDBC.
`static Timestamp`	`valueOf(LocalDateTime dateTime)` Получает экземпляр `Timestamp` от a `LocalDateTime` объект, с тем же самым годом, месяцем, днем месяца, часов, минут, секунд и nanos разового датой значения как обеспеченный `LocalDateTime`.
`static Timestamp`	`valueOf(String s)` Преобразовывает a `String` объект в JDBC добавляет метку времени к формату escape к a `Timestamp` значение.

Методы, наследованные от class java.util. Дата
after, before, clone, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTimezoneOffset, getYear, parse, setDate, setHours, setMinutes, setMonth, setSeconds, setYear, toGMTString, toLocaleString, UTC

Методы, наследованные от class java.lang. Объект
finalize, getClass, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - Метка времени
```
@Deprecated
public Timestamp(int year,
                             int month,
                             int date,
                             int hour,
                             int minute,
                             int second,
                             int nano)
```
    Осуждаемый. вместо этого используйте конструктора Timestamp(long millis)
    
    Конструкции a 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 параметр за пределы
  - Метка времени
```
public Timestamp(long time)
```
    Конструкции a Timestamp объект используя временную стоимость миллисекунд. Интегральные секунды сохранены в базовом значении даты; доли секунды сохранены в nanos поле Timestamp объект.
    
    Параметры:
    
    time - миллисекунды с 1 января 1970, GMT 0:00:00. Отрицательное число является числом миллисекунд до 1 января 1970, GMT 0:00:00.
    
    См. Также:
    
    Calendar
- Деталь метода
  - setTime
```
public void setTime(long time)
```
    Наборы это Timestamp объект представить момент времени, который является миллисекундами time после 1 января 1970 GMT 0:00:00.
    
    Переопределения:
    
    setTime в class Date
    
    Параметры:
    
    time - число миллисекунд.
    
    См. Также:
    
    getTime(), Timestamp(long time), Calendar
  - getTime
```
public long getTime()
```
    Возвращает число миллисекунд с 1 января 1970, GMT 0:00:00, представленный этим Timestamp объект.
    
    Переопределения:
    
    getTime в class Date
    
    Возвраты:
    
    число миллисекунд с 1 января 1970, GMT 0:00:00 представляется этой датой.
    
    См. Также:
    
    setTime(long)
  - valueOf
```
public static Timestamp valueOf(String s)
```
    Преобразовывает a String объект в JDBC добавляет метку времени к формату escape к a 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
```
public String toString()
```
    Форматирует метку времени в формате escape метки времени JDBC. yyyy-mm-dd hh:mm:ss.fffffffff, где ffffffffff указывает на наносекунды.
    
    Переопределения:
    
    toString в class Date
    
    Возвраты:
    
    a 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()
  - равняется
```
public boolean equals(Timestamp ts)
```
    Тесты, чтобы видеть, если это Timestamp объект равен данному Timestamp объект.
    
    Параметры:
    
    ts - Timestamp значение, чтобы сравниться с
    
    Возвраты:
    
    true если данный Timestamp объект равен этому Timestamp объект; false иначе
  - равняется
```
public boolean equals(Object ts)
```
    Тесты, чтобы видеть, если это Timestamp объект равен данному объекту. Эта версия метода equals был добавлен, чтобы фиксировать неправильную подпись Timestamp.equals(Timestamp) и сохранить обратную совместимость с существующими файлами class. Отметьте: Этот метод не симметричен относительно equals(Object) метод в основном class.
    
    Переопределения:
    
    equals в class Date
    
    Параметры:
    
    ts - Object значение, чтобы сравниться с
    
    Возвраты:
    
    true если данный Object экземпляр a Timestamp это равно этому Timestamp объект; false иначе
    
    См. Также:
    
    Date.getTime()
  - прежде
```
public boolean before(Timestamp ts)
```
    Указывает ли это Timestamp объект ранее чем данный Timestamp объект.
    
    Параметры:
    
    ts - Timestamp значение, чтобы сравниться с
    
    Возвраты:
    
    true если это Timestamp объект ранее; false иначе
  - после
```
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 в class Date
    
    Параметры:
    
    o - Date быть по сравнению с этим Timestamp объект
    
    Возвраты:
    
    значение 0 если это Timestamp возразите и данный объект равны; значение меньше чем 0 если это Timestamp объект перед данным параметром; и значение, больше чем 0 если это Timestamp объект после данного параметра.
    
    С тех пор:
    
    1.5
  - хэш-код
```
public int hashCode()
```
    Возвращает значение хэш-кода для этого объекта. Результатом является монопольное ИЛИ двух половин примитивного значения long, возвращенного Date.getTime() метод. Таким образом, хэш-код является значением выражения:
    (int)(this.getTime()^(this.getTime() >>> 32))
    hashCode метод использует базовое java.util.Date реализация и поэтому не включает nanos в свое вычисление.
    Переопределения:
    
    hashCode в class Date
    
    Возвраты:
    
    значение хэш-кода для этого объекта.
    
    См. Также:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - valueOf
```
public static Timestamp valueOf(LocalDateTime dateTime)
```
    Получает экземпляр Timestamp от a LocalDateTime объект, с тем же самым годом, месяцем, днем месяца, часов, минут, секунд и nanos разового датой значения как обеспеченный LocalDateTime.
    Обеспеченный LocalDateTime интерпретируется как локальная переменная, разовая датой в зоне местного времени.
    
    Параметры:
    
    dateTime - a LocalDateTime преобразовать
    
    Возвраты:
    
    a Timestamp объект
    
    Броски:
    
    NullPointerException - если dateTime нуль.
    
    С тех пор:
    
    1.8
  - toLocalDateTime
```
public LocalDateTime toLocalDateTime()
```
    Преобразовывает это Timestamp возразите против a LocalDateTime.
    Преобразование создает a LocalDateTime это представляет тот же самый год, месяц, день месяца, часов, минут, секунд и nanos разового датой значения как это Timestamp в зоне местного времени.
    
    Возвраты:
    
    a LocalDateTime объект, представляющий то же самое разовое датой значение
    
    С тех пор:
    
    1.8
  - от
```
public static Timestamp from(Instant instant)
```
    Получает экземпляр Timestamp от Instant объект.
    Instant может сохранить точки на временной шкале далее в будущем и далее в прошлом чем Date. В этом сценарии этот метод выдаст исключение.
    
    Параметры:
    
    instant - момент, чтобы преобразовать
    
    Возвраты:
    
    Timestamp представление той же самой точки на временной шкале как обеспеченный момент
    
    Броски:
    
    NullPointerException - если instant нуль.
    
    IllegalArgumentException - если момент является слишком большим, чтобы представить как a Timesamp
    
    С тех пор:
    
    1.8
  - toInstant
```
public Instant toInstant()
```
    Преобразовывает это Timestamp возразите против Instant.
    Преобразование создает Instant это представляет ту же самую точку на временной шкале как это Timestamp.
    
    Переопределения:
    
    toInstant в class Date
    
    Возвраты:
    
    момент, представляя ту же самую точку на временной шкале
    
    С тех пор:
    
    1.8

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Метка времени класса

Сводка конструктора

Сводка метода

Методы, наследованные от class java.util. Дата

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

Деталь конструктора

Метка времени

Метка времени

Деталь метода

setTime

getTime

valueOf

toString

getNanos

setNanos

равняется

равняется

прежде

после

compareTo

compareTo

хэш-код

valueOf

toLocalDateTime

от

toInstant