Home How it Works Android APIMiner IDE Version More Info

to top

Interfaces
- Array
- Blob
- CallableStatement
- Clob
- Connection
- DatabaseMetaData
- Driver
- NClob
- ParameterMetaData
- PreparedStatement
- Ref
- ResultSet
- ResultSetMetaData
- RowId
- Savepoint
- SQLData
- SQLInput
- SQLOutput
- SQLXML
- Statement
- Struct
- Wrapper
Classes
- Date
- DriverManager
- DriverPropertyInfo
- SQLPermission
- Time
- Timestamp
- Types
Enums
- ClientInfoStatus
- RowIdLifetime
Exceptions

Summary: Ctors | Methods | Inherited Methods | [Expand All]

Added in API level 1

public class

Timestamp

extends Date

java.lang.Object
↳	java.util.Date
	↳	java.sql.Timestamp

Class Overview

A Java representation of the SQL TIMESTAMP type. It provides the capability of representing the SQL TIMESTAMP nanosecond value, in addition to the regular date/time value which has millisecond resolution.

The Timestamp class consists of a regular date/time value, where only the integral seconds value is stored, plus a nanoseconds value where the fractional seconds are stored.

The addition of the nanosecond value field to the Timestamp object makes it significantly different from the java.util.Date object which it extends. Users should be aware that Timestamp objects are not interchangable with java.util.Date objects when used outside the confines of the java.sql package.

Summary

Public Constructors
	Timestamp(int theYear, int theMonth, int theDate, int theHour, int theMinute, int theSecond, int theNano) This constructor was deprecated in API level 1. Use the constructor `Timestamp(long)`.
	Timestamp(long theTime) Returns a `Timestamp` object corresponding to the time represented by a supplied time value.

Public Methods
boolean	after( Timestamp theTimestamp) Returns `true` if this timestamp object is later than the supplied timestamp, otherwise returns `false`.
boolean	before( Timestamp theTimestamp) Returns `true` if this `Timestamp` object is earlier than the supplied timestamp, otherwise returns `false`.
int	compareTo( Date theObject) Compares this `Timestamp` object with a supplied `Timestamp` object.
int	compareTo( Timestamp theTimestamp) Compares this `Timestamp` object with a supplied `Timestamp` object.
boolean	equals( Timestamp theTimestamp) Tests to see if this timestamp is equal to a supplied timestamp.
boolean	equals( Object theObject) Tests to see if this timestamp is equal to a supplied object.
int	getNanos() Gets this `Timestamp`'s nanosecond value
long	getTime() Returns the time represented by this `Timestamp` object, as a long value containing the number of milliseconds since the Epoch (January 1 1970, 00:00:00.000 GMT).
void	setNanos(int n) Sets the nanosecond value for this `Timestamp`.
void	setTime(long theTime) Sets the time represented by this `Timestamp` object to the supplied time, defined as the number of milliseconds since the Epoch (January 1 1970, 00:00:00.000 GMT).
String	toString() Returns the timestamp formatted as a String in the JDBC Timestamp Escape format, which is `"yyyy-MM-dd HH:mm:ss.nnnnnnnnn"`.
static Timestamp	valueOf( String s) Creates a `Timestamp` object with a time value equal to the time specified by a supplied String holding the time in JDBC timestamp escape format, which is `"yyyy-MM-dd HH:mm:ss.nnnnnnnnn`"

[Expand]

Inherited Methods

From class java.util.Date

static long	UTC(int year, int month, int day, int hour, int minute, int second) This method was deprecated in API level 1. use: `Calendar cal = new GregorianCalendar(TimeZone.getTimeZone("GMT")); cal.set(year + 1900, month, day, hour, minute, second); cal.getTime().getTime();`
boolean	after( Date date) Returns if this `Date` is after the specified Date.
boolean	before( Date date) Returns if this `Date` is before the specified Date.
Object	clone() Returns a new `Date` with the same millisecond value as this `Date`.
int	compareTo( Date date) Compare the receiver to the specified `Date` to determine the relative ordering.
boolean	equals( Object object) Compares the specified object to this `Date` and returns if they are equal.
int	getDate() This method was deprecated in API level 1. use `Calendar.get(Calendar.DATE)`
int	getDay() This method was deprecated in API level 1. use `Calendar.get(Calendar.DAY_OF_WEEK)`
int	getHours() This method was deprecated in API level 1. use `Calendar.get(Calendar.HOUR_OF_DAY)`
int	getMinutes() This method was deprecated in API level 1. use `Calendar.get(Calendar.MINUTE)`
int	getMonth() This method was deprecated in API level 1. use `Calendar.get(Calendar.MONTH)`
int	getSeconds() This method was deprecated in API level 1. use `Calendar.get(Calendar.SECOND)`
long	getTime() Returns this `Date` as a millisecond value.
int	getTimezoneOffset() This method was deprecated in API level 1. use `(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / 60000`
int	getYear() This method was deprecated in API level 1. use `Calendar.get(Calendar.YEAR) - 1900`
int	hashCode() Returns an integer hash code for the receiver.
static long	parse( String string) This method was deprecated in API level 1. use `DateFormat`
void	setDate(int day) This method was deprecated in API level 1. use `Calendar.set(Calendar.DATE, day)`
void	setHours(int hour) This method was deprecated in API level 1. use `Calendar.set(Calendar.HOUR_OF_DAY, hour)`
void	setMinutes(int minute) This method was deprecated in API level 1. use `Calendar.set(Calendar.MINUTE, minute)`
void	setMonth(int month) This method was deprecated in API level 1. use `Calendar.set(Calendar.MONTH, month)`
void	setSeconds(int second) This method was deprecated in API level 1. use `Calendar.set(Calendar.SECOND, second)`
void	setTime(long milliseconds) Sets this `Date` to the specified millisecond value.
void	setYear(int year) This method was deprecated in API level 1. use `Calendar.set(Calendar.YEAR, year + 1900)`
String	toGMTString() This method was deprecated in API level 1. use `DateFormat`
String	toLocaleString() This method was deprecated in API level 1. use `DateFormat`
String	toString() Returns a string representation of this `Date`.

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals( Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface java.lang.Comparable

Public Constructors

public Timestamp (int theYear, int theMonth, int theDate, int theHour, int theMinute, int theSecond, int theNano)

Added in API level 1

This constructor was deprecated in API level 1.
Use the constructor Timestamp(long).

Returns a Timestamp corresponding to the time specified by the supplied values for Year, Month, Date, Hour, Minutes, Seconds and Nanoseconds.

Parameters

theYear	specified as the year minus 1900.
theMonth	specified as an integer in the range [0,11].
theDate	specified as an integer in the range [1,31].
theHour	specified as an integer in the range [0,23].
theMinute	specified as an integer in the range [0,59].
theSecond	specified as an integer in the range [0,59].
theNano	which defines the nanosecond value of the timestamp specified as an integer in the range [0,999'999'999]

Throws

IllegalArgumentException	if any of the parameters is out of range.

public Timestamp (long theTime)

Added in API level 1

Returns a Timestamp object corresponding to the time represented by a supplied time value.

Parameters

theTime	a time value in the format of milliseconds since the Epoch (January 1 1970 00:00:00.000 GMT).

Public Methods

public boolean after (Timestamp theTimestamp)

Added in API level 1

Returns true if this timestamp object is later than the supplied timestamp, otherwise returns false.

Parameters

theTimestamp	the timestamp to compare with this timestamp object.

Returns

true if this Timestamp object is later than the supplied timestamp, false otherwise.

public boolean before (Timestamp theTimestamp)

Added in API level 1

Returns true if this Timestamp object is earlier than the supplied timestamp, otherwise returns false.

Parameters

theTimestamp	the timestamp to compare with this `Timestamp` object.

Returns

true if this Timestamp object is earlier than the supplied timestamp, false otherwise.

public int compareTo (Date theObject)

Added in API level 1

Compares this Timestamp object with a supplied Timestamp object.

Parameters

theObject	the timestamp to compare with this `Timestamp` object, passed as an `Object`.

Returns

0 if the two Timestamp objects are equal in time

a value < 0 if this Timestamp object is before the supplied Timestamp and a value

> 0 if this Timestamp object is after the supplied Timestamp

Throws

ClassCastException	if the supplied object is not a `Timestamp` object.

public int compareTo (Timestamp theTimestamp)

Added in API level 1

Compares this Timestamp object with a supplied Timestamp object.

Parameters

theTimestamp	the timestamp to compare with this `Timestamp` object, passed in as a `Timestamp`.

Returns

one of the following:
- 0, if the two Timestamp objects are equal in time
- < 0, if this Timestamp object is before the supplied Timestamp
- > 0, if this Timestamp object is after the supplied Timestamp

public boolean equals (Timestamp theTimestamp)

Added in API level 1

Tests to see if this timestamp is equal to a supplied timestamp.

Parameters

theTimestamp	the timestamp to compare with this `Timestamp` object, passed as an `Object`.

Returns

true if this Timestamp object is equal to the supplied Timestamp object, false otherwise.

public boolean equals (Object theObject)

Added in API level 1

Tests to see if this timestamp is equal to a supplied object.

Parameters

theObject	the object to which this timestamp is compared.

Returns

true if this Timestamp object is equal to the supplied Timestamp object
false if the object is not a Timestamp object or if the object is a Timestamp but represents a different instant in time.

public int getNanos ()

Added in API level 1

Gets this Timestamp's nanosecond value

Returns

The timestamp's nanosecond value, an integer between 0 and 999,999,999.

public long getTime ()

Added in API level 1

Returns the time represented by this Timestamp object, as a long value containing the number of milliseconds since the Epoch (January 1 1970, 00:00:00.000 GMT).

Returns

the number of milliseconds that have passed since January 1 1970, 00:00:00.000 GMT.

public void setNanos (int n)

Added in API level 1

Sets the nanosecond value for this Timestamp.

Parameters

n	number of nanoseconds.

Throws

IllegalArgumentException	if number of nanoseconds smaller than 0 or greater than 999,999,999.

public void setTime (long theTime)

Added in API level 1

Sets the time represented by this Timestamp object to the supplied time, defined as the number of milliseconds since the Epoch (January 1 1970, 00:00:00.000 GMT).

Parameters

theTime	number of milliseconds since the Epoch (January 1 1970, 00:00:00.000 GMT).

public String toString ()

Added in API level 1

Returns the timestamp formatted as a String in the JDBC Timestamp Escape format, which is "yyyy-MM-dd HH:mm:ss.nnnnnnnnn".

Returns

A string representing the instant defined by the Timestamp, in JDBC Timestamp escape format.

public static Timestamp valueOf (String s)

Added in API level 1

Creates a Timestamp object with a time value equal to the time specified by a supplied String holding the time in JDBC timestamp escape format, which is "yyyy-MM-dd HH:mm:ss.nnnnnnnnn"

Parameters

s	the `String` containing a time in JDBC timestamp escape format.

Returns

A Timestamp object with time value as defined by the supplied String.

Throws

IllegalArgumentException	if the provided string is `null`.

information

No examples for this method.

Frequently called with: [Clear]

This example was provided by APIMiner.

Portions of this page are reproduced from work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. The original page is available here.

Results

Interfaces

Classes

Enums

Exceptions

Timestamp

Class Overview

See Also

Summary

Public Constructors

public Timestamp (int theYear, int theMonth, int theDate, int theHour, int theMinute, int theSecond, int theNano)

Parameters

Throws

public Timestamp (long theTime)

Parameters

Public Methods

public boolean after (Timestamp theTimestamp)

Parameters

Returns

public boolean before (Timestamp theTimestamp)

Parameters

Returns

public int compareTo (Date theObject)

Parameters

Returns

Throws

public int compareTo (Timestamp theTimestamp)

Parameters

Returns

public boolean equals (Timestamp theTimestamp)

Parameters

Returns

public boolean equals (Object theObject)

Parameters

Returns

public int getNanos ()

Returns

public long getTime ()

Returns

public void setNanos (int n)

Parameters

Throws

public void setTime (long theTime)

Parameters

public String toString ()

Returns

public static Timestamp valueOf (String s)

Parameters

Returns

Throws