Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.
Copyright © 2006 Sun Microsystems, Inc. All rights reserved.
java.sql
Class Date
java.lang.Object
|
+--java.util.Date
|
+--java.sql.Date
- All Implemented Interfaces:
- java.lang.Cloneable, java.lang.Comparable, java.io.Serializable
- public class Date
- extends java.util.Date
A thin wrapper around a millisecond value that allows
JDBC to identify this as an SQL DATE
value. A
milliseconds value represents the number of milliseconds that
have passed since January 1, 1970 00:00:00.000 GMT.
To conform with the definition of SQL DATE
, the
millisecond values wrapped by a java.sql.Date
instance
must be 'normalized' by setting the
hours, minutes, seconds, and milliseconds to zero in the particular
time zone with which the instance is associated.
- See Also:
- Serialized Form
Constructor Summary |
Date(long date)
Constructs a Date object using the given milliseconds
time value. |
Method Summary |
void |
setTime(long date)
Sets an existing Date object
using the given milliseconds time value. |
java.lang.String |
toString()
Formats a date in the date escape format yyyy-mm-dd. |
static Date |
valueOf(java.lang.String s)
Converts a string in JDBC date escape format to
a Date value. |
Methods inherited from class java.util.Date |
after, before, clone, compareTo, compareTo, equals, getTime, hashCode |
Methods inherited from class java.lang.Object |
finalize, getClass, notify, notifyAll, wait, wait, wait |
Date
public Date(long date)
- Constructs a
Date
object using the given milliseconds
time value. If the given milliseconds value contains time
information, the driver will set the time components to the
time in the default time zone (the time zone of the Java virtual
machine running the application) that corresponds to zero GMT.
- Parameters:
date
- milliseconds since January 1, 1970, 00:00:00 GMT not
to exceed the milliseconds representation for the year 8099.
A negative number indicates the number of milliseconds
before January 1, 1970, 00:00:00 GMT.
setTime
public void setTime(long date)
- Sets an existing
Date
object
using the given milliseconds time value.
If the given milliseconds value contains time information,
the driver will set the time components to the
time in the default time zone (the time zone of the Java virtual
machine running the application) that corresponds to zero GMT.
- Overrides:
setTime
in class java.util.Date
- Parameters:
date
- milliseconds since January 1, 1970, 00:00:00 GMT not
to exceed the milliseconds representation for the year 8099.
A negative number indicates the number of milliseconds
before January 1, 1970, 00:00:00 GMT.
valueOf
public static Date valueOf(java.lang.String s)
- Converts a string in JDBC date escape format to
a
Date
value.
- Parameters:
s
- date in format "yyyy-mm-dd"- Returns:
- a
java.sql.Date
object representing the
given date
toString
public java.lang.String toString()
- Formats a date in the date escape format yyyy-mm-dd.
NOTE: To specify a date format for the class
SimpleDateFormat
, use "yyyy.MM.dd" rather than
"yyyy-mm-dd". In the context of SimpleDateFormat
,
"mm" indicates minutes rather than the month.
For example:
Format Pattern Result
-------------- -------
"yyyy.MM.dd G 'at' hh:mm:ss z" ->> 1996.07.10 AD at 15:08:56 PDT
- Overrides:
toString
in class java.util.Date
- Returns:
- a String in yyyy-mm-dd format
Copyright © 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.
For more information, please consult the JSR 169 specification.