JavaTM Platform
Standard Ed. 6

java.sql
클래스 Timestamp

java.lang.Object 
  상위를 확장 java.util.Date 
      상위를 확장 java.sql.Timestamp
모든 구현된 인터페이스:
Serializable , Cloneable , Comparable <Date >


public class Timestamp
extends Date

이 클래스는,java.util.Date 의 thin 래퍼로, 이 래퍼에 의해 JDBC API 는 이것을 SQL TIMESTAMP 치로서 식별할 수 있습니다. 이 클래스는, 소수점 이하의 초수의 스펙으로 나노초의 정밀도를 허가하는 것으로써, SQL TIMESTAMP 의 소수점 이하의 초수치를 보관 유지하는 기능을 추가합니다. Timestamp 는, 타임 스탬프치의 JDBC 이스케이프 구문을 지원하기 위한 포맷과 구문 분석 조작도 제공합니다.

Timestamp 객체의 정밀도는, 다음과 같이 계산됩니다.

주: 이 형태는 java.util.Date 와 나노초치로부터 됩니다. java.util.Date 원가요소내에 포함되는 것은 초의 정수 부분 뿐이어서, 초의 소수점 이하 (nanos 치)는 다른 원가요소내에 포함됩니다. Timestamp.equals(Object) 메소드는,java.sql.Timestamp 의 인스턴스가 아닌 객체가 건네받았을 경우는 true 를 돌려주지 않습니다. 왜냐하면, 그 일자의 nanos 원가요소가 불명하기 때문에입니다. 그 때문에,Timestamp.equals(Object) 메소드는 java.util.Date.equals(Object) 메소드와 대칭이 아닙니다. 또,hashcode 메소드는 기가 되는 java.util.Date 구현을 사용하기 위해(때문에), 그 계산에 nanos 치를 포함하지 않습니다.  

상기와 같은 Timestamp 클래스와 java.util.Date 클래스의 차이이기 때문에,Timestamp 치는 java.util.Date 의 인스턴스로서 생각하지 말아 주세요. Timestampjava.util.Date 의 상속 관계는, 형태의 상속은 아니고, 구현의 상속을 나타냅니다.

관련 항목:
직렬화 된 형식

생성자 의 개요
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 (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 ()
          Timestamp 객체로 나타내지는, 1970 년 1 월 1 일, 0 시 0 분 0 초 GMT (그리니지 표준시)로부터의 밀리 세컨드수를 돌려줍니다.
 void setNanos (int n)
          이 Timestamp 객체의 nanos 필드가 지정된 값으로 설정합니다.
 void setTime (long time)
          이 Timestamp 객체를, 1970 년 1 월 1 일, 0 시 0 분 0 초 GMT (그리니지 표준시)로부터 time 밀리 세컨드의 시점을 나타내도록(듯이) 설정합니다.
 String toString ()
          타임 스탬프를, JDBC 타임 스탬프 이스케이프 형식 (yyyy-mm-dd hh:mm:ss.fffffffff,ffffffffff 는 나노초를 나타낸다)에 포맷 합니다.
static Timestamp valueOf (String  s)
          JDBC 타임 스탬프 이스케이프 형식의 String 객체를 Timestamp 치로 변환합니다.
 
클래스 java.util. Date 로부터 상속된 메소드
after , before , clone , getDate , getDay , getHours , getMinutes , getMonth , getSeconds , getTimezoneOffset , getYear , hashCode , parse , setDate , setHours , setMinutes , setMonth , setSeconds , setYear , toGMTString , toLocaleString , UTC
 
클래스 java.lang. Object 로부터 상속된 메소드
finalize , getClass , notify , notifyAll , wait , wait , wait
 

생성자 의 상세

Timestamp

@Deprecated 
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 객체를 구축합니다. 정수치의 초는 date 치에 포함되어 소수점 이하의 초수는 Timestamp 객체의 nanos 필드에 포함됩니다.

파라미터:
time - 1970 년 1 월 1 일, 0 시 0 분 0 초 GMT (그리니지 표준시)를 기점으로 한 시간을 밀리 세컨드로 나타낸 값. 0 보다 작은 값은, 1970 년 1 월 1 일, 0 시 0 분 0 초 GMT (그리니지 표준시)보다 전의 밀리 세컨드
관련 항목:
Calendar
메소드의 상세

setTime

public void setTime(long time)
Timestamp 객체를, 1970 년 1 월 1 일, 0 시 0 분 0 초 GMT (그리니지 표준시)로부터 time 밀리 세컨드의 시점을 나타내도록(듯이) 설정합니다.

오버라이드(override):
클래스 Date 내의 setTime
파라미터:
time - 밀리 세컨드수
관련 항목:
getTime() , Timestamp(long time) , Calendar

getTime

public long getTime()
Timestamp 객체로 나타내지는, 1970 년 1 월 1 일, 0 시 0 분 0 초 GMT (그리니지 표준시)로부터의 밀리 세컨드수를 돌려줍니다.

오버라이드(override):
클래스 Date 내의 getTime
반환값:
이 일자로 나타내지는, 1970 년 1 월 1 일 00:00:00 GMT 로부터의 밀리 세컨드수
관련 항목:
setTime(long)

valueOf

public static Timestamp  valueOf(String  s)
JDBC 타임 스탬프 이스케이프 형식의 String 객체를 Timestamp 치로 변환합니다.

파라미터:
s - yyyy-mm-dd hh:mm:ss[. f...] 형식의 타임 스탬프. 소수점 이하의 초수는 생략 되는 일이 있다
반환값:
대응하는 Timestamp
예외:
IllegalArgumentException - 지정된 인수가 yyyy-mm-dd hh:mm:ss[. f...] 형식이 아닌 경우

toString

public String  toString()
타임 스탬프를, JDBC 타임 스탬프 이스케이프 형식 (yyyy-mm-dd hh:mm:ss.fffffffff,ffffffffff 는 나노초를 나타낸다)에 포맷 합니다.  

오버라이드(override):
클래스 Date 내의 toString
반환값:
yyyy-mm-dd hh:mm:ss.fffffffff 형식의 String 객체
관련 항목:
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
반환값:
지정된 Timestamp 객체가 이 Timestamp 객체와 동일한 경우는 true, 그렇지 않은 경우는 false

equals

public boolean equals(Object  ts)
Timestamp 객체가 지정된 객체와 동일한지 어떤지를 판정합니다. 이 버젼의 equals 메소드는,Timestamp.equals(Timestamp) 의 올바르지 않은 시그니챠의 수정과 기존의 클래스 파일과의 하위 호환을 보관 유지하기 위해서 추가되었습니다. 주:이 메소드는, base class의 equals(Object) 메소드와 대칭이 아닙니다.

오버라이드(override):
클래스 Date 내의 equals
파라미터:
ts - 비교 대상의 Object
반환값:
지정된 ObjectTimestamp 의 인스턴스이며, 이 Timestamp 객체와 동일한 경우는 true, 그렇지 않은 경우는 false
관련 항목:
Date.getTime()

before

public boolean before(Timestamp  ts)
Timestamp 객체가, 지정된 Timestamp 객체보다 빠른 시각인가 어떤가를 나타냅니다.

파라미터:
ts - 비교 대상의 Timestamp
반환값:
Timestamp 객체가 빠른 경우는 true, 그렇지 않은 경우는 false

after

public boolean after(Timestamp  ts)
Timestamp 객체가, 지정된 Timestamp 객체보다 늦은 시각인가 어떤가를 나타냅니다.

파라미터:
ts - 비교 대상의 Timestamp
반환값:
Timestamp 객체가 늦은 경우는 true, 그렇지 않은 경우는 false

compareTo

public int compareTo(Timestamp  ts)
Timestamp 객체를, 지정된 Timestamp 객체와 비교합니다.

파라미터:
ts - 이 Timestamp 객체와 비교하는 Timestamp 객체
반환값:
2 개의 Timestamp 객체가 동일한 경우는 값 0, 이 Timestamp 객체가 인수로 지정된 객체보다 빠른 시각인 경우는 0 보다 작은 값, 이 Timestamp 객체가 인수로 지정된 객체보다 늦은 시각인 경우는 정의 값
도입된 버젼:
1.4

compareTo

public int compareTo(Date  o)
Timestamp 객체가 지정된 Date 와 비교합니다. 다만, 인수는 Timestamp 객체가 될 필요가 있습니다. 인수가 Timestamp 객체가 아닌 경우, 이 메소드는 ClassCastException 객체를 throw 합니다 (Timestamp 객체는 다른 Timestamp 객체로 밖에 비교할 수 없다).

정의:
인터페이스 Comparable <Date > 내의 compareTo
오버라이드(override):
클래스 Date 내의 compareTo
파라미터:
o - 비교 대상의 Date. Timestamp 객체가 될 필요가 있다
반환값:
Timestamp 객체와 지정된 객체가 동일한 경우는 값 0, 이 Timestamp 객체가 인수로 지정된 객체보다 빠른 시각인 경우는 0 보다 작은 값, 이 Timestamp 객체가 인수로 지정된 객체보다 늦은 시각인 경우는 정의 값
도입된 버젼:
1.5

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.