public class Date extends 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.
Constructor and Description |
---|
Date(int year,
int month,
int day)
Deprecated.
instead use the constructor
Date(long date) |
Date(long date)
Constructs a
Date object using the given milliseconds
time value. |
Modifier and Type | Method and Description |
---|---|
int |
getHours()
Deprecated.
This method is deprecated and should not be used because SQL Date
values do not have a time component.
|
int |
getMinutes()
Deprecated.
This method is deprecated and should not be used because SQL Date
values do not have a time component.
|
int |
getSeconds()
Deprecated.
This method is deprecated and should not be used because SQL Date
values do not have a time component.
|
void |
setHours(int i)
Deprecated.
This method is deprecated and should not be used because SQL Date
values do not have a time component.
|
void |
setMinutes(int i)
Deprecated.
This method is deprecated and should not be used because SQL Date
values do not have a time component.
|
void |
setSeconds(int i)
Deprecated.
This method is deprecated and should not be used because SQL Date
values do not have a time component.
|
void |
setTime(long date)
Sets an existing
Date object
using the given milliseconds time value. |
String |
toString()
Formats a date in the date escape format yyyy-mm-dd.
|
static Date |
valueOf(String s)
Converts a string in JDBC date escape format to
a
Date value. |
@Deprecated public Date(int year, int month, int day)
Date(long date)
Date
object initialized with the given
year, month, and day.
The result is undefined if a given argument is out of bounds.
year
- the year minus 1900; must be 0 to 8099. (Note that
8099 is 9999 minus 1900.)month
- 0 to 11day
- 1 to 31public Date(long date)
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.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.public void setTime(long date)
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.public static Date valueOf(String s)
Date
value.s
- a String
object representing a date in
in the format "yyyy-[m]m-[d]d". The leading zero for mm
and dd
may also be omitted.java.sql.Date
object representing the
given dateIllegalArgumentException
- if the date given is not in the
JDBC date escape format (yyyy-[m]m-[d]d)public String toString()
toString
in class Date
Date.toLocaleString()
,
Date.toGMTString()
@Deprecated public int getHours()
Date
getHours
in class Date
IllegalArgumentException
- if this method is invokedsetHours(int)
@Deprecated public int getMinutes()
Date
0
and 59
.getMinutes
in class Date
IllegalArgumentException
- if this method is invokedsetMinutes(int)
@Deprecated public int getSeconds()
Date
0
and 61
. The
values 60
and 61
can only occur on those
Java Virtual Machines that take leap seconds into account.getSeconds
in class Date
IllegalArgumentException
- if this method is invokedsetSeconds(int)
@Deprecated public void setHours(int i)
Date
setHours
in class Date
i
- the hour value.IllegalArgumentException
- if this method is invokedgetHours()
@Deprecated public void setMinutes(int i)
Date
setMinutes
in class Date
i
- the value of the minutes.IllegalArgumentException
- if this method is invokedgetMinutes()
@Deprecated public void setSeconds(int i)
Date
setSeconds
in class Date
i
- the seconds value.IllegalArgumentException
- if this method is invokedgetSeconds()