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

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 класс и java.util.Date упомянутый выше класс, рекомендуется, чтобы тот код не просмотрел 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` объект.
`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.
`Строка`	`toString()` Форматирует метку времени в формате escape метки времени JDBC.
`static Timestamp`	`valueOf(String s)` Преобразовывает a `String` объект в метке времени JDBC выходит из формата к a `Timestamp` значение.

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

Методы 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 в классе Date
    
    Параметры:
    time - число миллисекунд.
    См. Также:
    getTime(), Timestamp(long time), Calendar
  - getTime
```
public long getTime()
```
    Возвращает число миллисекунд с 1 января 1970, GMT 0:00:00, представленный этим Timestamp объект.
    
    Переопределения:
    
    getTime в классе Date
    
    Возвраты:
    число миллисекунд с 1 января 1970, GMT 0:00:00 представляется этой датой.
    См. Также:
    setTime(long)
  - valueOf
```
public static Timestamp valueOf(String s)
```
    Преобразовывает a String объект в метке времени JDBC выходит из формата к 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 в классе 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) и сохранить обратную совместимость с существующими файлами класса. Отметьте: Этот метод не симметричен относительно equals(Object) метод в базовом классе.
    
    Переопределения:
    
    equals в классе 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 в классе 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 в классе Date
    
    Возвраты:
    значение хэш-кода для этого объекта.
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

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

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

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

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

Методы java.util унаследованный от класса. Дата

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

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

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

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

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

setTime

getTime

valueOf

toString

getNanos

setNanos

равняется

равняется

прежде

после

compareTo

compareTo

хэш-код