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.
|
int |
getMinutes()
Deprecated.
|
int |
getSeconds()
Deprecated.
|
void |
setHours(int i)
Deprecated.
|
void |
setMinutes(int i)
Deprecated.
|
void |
setSeconds(int i)
Deprecated.
|
void |
setTime(long date)
Sets an existing
Date object using the given milliseconds time value.
|
Instant |
toInstant()
This method always throws an UnsupportedOperationException and should not be used because SQL
Date values do not have a time component.
|
LocalDate |
toLocalDate()
Converts this
Date object to a
LocalDate
|
String |
toString()
Formats a date in the date escape format yyyy-mm-dd.
|
static Date |
valueOf(LocalDate
Obtains an instance of
Date from a
LocalDate object with the same year, month and day of month value as the given
LocalDate.
|
static Date |
valueOf(String
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 11
day - 1 to 31
public 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 DatevalueOf(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 date
IllegalArgumentException - if the date given is not in the JDBC date escape format (yyyy-[m]m-[d]d)
public StringtoString()
toString in class
Date
Date.toLocaleString() ,
Date.toGMTString()
@Deprecated public int getHours()
getHours in class
Date
IllegalArgumentException - if this method is invoked
setHours(int)
@Deprecated public int getMinutes()
getMinutes in class
Date
IllegalArgumentException - if this method is invoked
setMinutes(int)
@Deprecated public int getSeconds()
getSeconds in class
Date
IllegalArgumentException - if this method is invoked
setSeconds(int)
@Deprecated public void setHours(int i)
setHours in class
Date
i - the hour value.
IllegalArgumentException - if this method is invoked
getHours()
@Deprecated public void setMinutes(int i)
setMinutes in class
Date
i - the value of the minutes.
IllegalArgumentException - if this method is invoked
getMinutes()
@Deprecated public void setSeconds(int i)
setSeconds in class
Date
i - the seconds value.
IllegalArgumentException - if this method is invoked
getSeconds()
public static DatevalueOf(LocalDate date)
Date from a
LocalDate object with the same year, month and day of month value as the given
LocalDate.
The provided LocalDate is interpreted as the local date in the local time zone.
date - a
LocalDate to convert
Date object
NullPointerException - if
date is null
public LocalDatetoLocalDate()
Date object to a
LocalDate
The conversion creates a LocalDate that represents the same date value as this Date in local time zone
LocalDate object representing the same date value
public InstanttoInstant()
Date values do not have a time component.
toInstant in class
Date
Date object
UnsupportedOperationException - if this method is invoked