java.util
public class Date extends Object implements Cloneable, Comparable<Date>, Serializable
This class represents a specific time in milliseconds since the epoch. The epoch is 1970, January 1 00:00:00.0000 UTC.
Date is intended to reflect universal time coordinate (UTC),
but this depends on the underlying host environment. Most operating systems
don't handle the leap second, which occurs about once every year or
so. The leap second is added to the last minute of the day on either
the 30th of June or the 31st of December, creating a minute 61 seconds
in length.
The representations of the date fields are as follows:
Prior to JDK 1.1, this class was the sole class handling date and time
related functionality. However, this particular solution was not
amenable to internationalization. The new Calendar
class should now be used to handle dates and times, with Date
being used only for values in milliseconds since the epoch. The
Calendar class, and its concrete implementations, handle
the interpretation of these values into minutes, hours, days, months
and years. The formatting and parsing of dates is left to the
DateFormat class, which is able to handle the different
types of date format which occur in different locales.
See Also: Calendar GregorianCalendar DateFormat
| Constructor Summary | |
|---|---|
| Date()
Creates a new Date Object representing the current time. | |
| Date(long time)
Creates a new Date Object representing the given time.
| |
| Date(int year, int month, int day)
Creates a new Date Object representing the given time.
| |
| Date(int year, int month, int day, int hour, int min)
Creates a new Date Object representing the given time.
| |
| Date(int year, int month, int day, int hour, int min, int sec)
Creates a new Date Object representing the given time.
| |
| Date(String s)
Creates a new Date from the given string representation. | |
| Method Summary | |
|---|---|
| boolean | after(Date when)
Tests if this date is after the specified date.
|
| boolean | before(Date when)
Tests if this date is before the specified date.
|
| Object | clone()
Returns a copy of this Date object.
|
| int | compareTo(Date when)
Compares two dates.
|
| boolean | equals(Object obj)
Compares two dates for equality.
|
| int | getDate()
Returns the day of the month of this Date
object, as a value between 0 and 31.
|
| int | getDay()
Returns the day represented by this Date
object as an integer between 0 (Sunday) and 6 (Saturday).
|
| int | getHours()
Returns the hours represented by this Date
object as an integer between 0 and 23.
|
| int | getMinutes()
Returns the number of minutes represented by the Date
object, as an integer between 0 and 59.
|
| int | getMonth()
Returns the month represented by this Date object,
as a value between 0 (January) and 11 (December).
|
| int | getSeconds()
Returns the number of seconds represented by the Date
object, as an integer between 0 and 61 (60 and 61 being leap seconds).
|
| long | getTime()
Gets the time represented by this object.
|
| int | getTimezoneOffset()
Returns the number of minutes offset used with UTC to give the time
represented by this object in the current time zone. |
| int | getYear()
Returns the difference between the year represented by this
Date object and 1900.
|
| int | hashCode()
Computes the hash code of this Date as the
XOR of the most significant and the least significant
32 bits of the 64 bit milliseconds value.
|
| static long | parse(String string) Parses a String and returns the time, in milliseconds since the epoch, it represents. |
| void | setDate(int date)
Sets the date to the given value. |
| void | setHours(int hours)
Sets the hours to the given value. |
| void | setMinutes(int minutes)
Sets the minutes to the given value. |
| void | setMonth(int month)
Sets the month to the given value. |
| void | setSeconds(int seconds)
Sets the seconds to the given value. |
| void | setTime(long time)
Sets the time which this object should represent.
|
| void | setYear(int year)
Sets the year to the specified year, plus 1900. |
| String | toGMTString()
Returns a string representation of this |
| String | toLocaleString()
Returns a locale-dependent string representation of this
Date object.
|
| String | toString() Returns a string representation of this date using the following date format:
where the fields used here are:
|
| static long | UTC(int year, int month, int date, int hrs, int min, int sec)
Returns the number of milliseconds since the epoch
specified by the given arguments. |
Parameters: time the time in milliseconds since the epoch.
Deprecated: use new GregorianCalendar(year+1900, month,
day) instead.
Parameters: year the difference between the required year and 1900. month the month as a value between 0 and 11. day the day as a value between 0 and 31.
Deprecated: use new GregorianCalendar(year+1900, month,
day, hour, min) instead.
Parameters: year the difference between the required year and 1900. month the month as a value between 0 and 11. day the day as a value between 0 and 31. hour the hour as a value between 0 and 23, in 24-hour clock notation. min the minute as a value between 0 and 59.
Deprecated: use new GregorianCalendar(year+1900, month,
day, hour, min, sec) instead.
Parameters: year the difference between the required year and 1900. month the month as a value between 0 and 11. day the day as a value between 0 and 31. hour the hour as a value between 0 and 23, in 24-hour clock notation. min the minute as a value between 0 and 59. sec the second as a value between 0 and 61 (with 60 and 61 being leap seconds).
Deprecated: use java.text.DateFormat.parse(s) instead.
new Date(Date.parse(s))See Also: Date
Parameters: when the other date
Returns: true, if the date represented by this object is strictly later than the time represented by when.
Parameters: when the other date
Returns: true, if the date represented by when is strictly later than the time represented by this object.
Date object.
Returns: a copy, or null if the object couldn't be cloned.
See Also: clone
Parameters: when the other date.
Returns: 0, if the date represented by obj is exactly the same as the time represented by this object, a negative if this Date is before the other Date, and a positive value otherwise.
Parameters: obj the object to compare.
Returns: true, if obj is a Date object and the time represented by obj is exactly the same as the time represented by this object.
Deprecated: Use Calendar instead of Date, and use get(Calendar.DATE) instead.
Returns the day of the month of thisDate
object, as a value between 0 and 31.
Returns: the day of month represented by this date object.
Deprecated: Use Calendar instead of Date, and use get(Calendar.DAY_OF_WEEK) instead.
Returns the day represented by thisDate
object as an integer between 0 (Sunday) and 6 (Saturday).
Returns: the day represented by this date object.
See Also: Calendar
Deprecated: Use Calendar instead of Date, and use get(Calendar.HOUR_OF_DAY) instead.
Returns the hours represented by thisDate
object as an integer between 0 and 23.
Returns: the hours represented by this date object.
Deprecated: Use Calendar instead of Date, and use get(Calendar.MINUTE) instead.
Returns the number of minutes represented by theDate
object, as an integer between 0 and 59.
Returns: the minutes represented by this date object.
Deprecated: Use Calendar instead of Date, and use get(Calendar.MONTH) instead.
Returns the month represented by thisDate object,
as a value between 0 (January) and 11 (December).
Returns: the month represented by this date object (zero based).
Deprecated: Use Calendar instead of Date, and use get(Calendar.SECOND) instead.
Returns the number of seconds represented by theDate
object, as an integer between 0 and 61 (60 and 61 being leap seconds).
Returns: the seconds represented by this date object.
Returns: the time in milliseconds since the epoch.
Deprecated: use
Calendar.get(Calendar.ZONE_OFFSET)+Calendar.get(Calendar.DST_OFFSET)
instead.
Returns: The time zone offset in minutes of the local time zone relative to UTC. The time represented by this object is used to determine if we should use daylight savings.
Deprecated: Use Calendar instead of Date, and use get(Calendar.YEAR) instead. Note the 1900 difference in the year.
Returns the difference between the year represented by thisDate object and 1900.
Returns: the year minus 1900 represented by this date object.
Date as the
XOR of the most significant and the least significant
32 bits of the 64 bit milliseconds value.
Returns: the hash code.
Deprecated: Use DateFormat.parse(String)
Parses a String and returns the time, in milliseconds since the
epoch, it represents. Most syntaxes are handled, including
the IETF date standard "day, dd mon yyyy hh:mm:ss zz" (see
toString() for definitions of these fields).
Standard U.S. time zone abbreviations are recognised, in
addition to time zone offsets in positive or negative minutes.
If a time zone is specified, the specified time is assumed to
be in UTC and the appropriate conversion is applied, following
parsing, to convert this to the local time zone. If no zone
is specified, the time is assumed to already be in the local
time zone.
The method parses the string progressively from left to right.
At the end of the parsing process, either a time is returned
or an IllegalArgumentException is thrown to signify
failure. The ASCII characters A-Z, a-z, 0-9, and ',', '+', '-',
':' and '/' are the only characters permitted within the string,
besides whitespace and characters enclosed within parantheses
'(' and ')'.
A sequence of consecutive digits are recognised as a number, and interpreted as follows:
Date class is initialised.. Given a century,
x, the year is assumed to be within the range x - 80 to x + 19. The value
itself is then used as a match against the two last digits of one of these
years. For example, take x to be 2004. A two-digit year is assumed to fall
within the range x - 80 (1924) and x + 19 (2023). Thus, any intepreted value
between 0 and 23 is assumed to be 2000 to 2023 and values between 24 and 99
are taken as being 1924 to 1999. This only applies for the case of 2004.
With a different year, the values will be interpreted differently. 2005
will used 0 to 24 as 2000 to 2024 and 25 to 99 as 1925 to 1999, for example.
This behaviour differs from that of SimpleDateFormat and is
time-dependent (a two-digit year will be interpreted differently depending
on the time the code is run).
A sequence of consecutive alphabetic characters is recognised as a word, and interpreted as follows, in a case-insentive fashion:
Parameters: string The String to parse.
Returns: The time in milliseconds since the epoch.
Throws: IllegalArgumentException if the string fails to parse.
See Also: toString SimpleDateFormat
Deprecated: Use Calendar instead of Date, and use set(Calendar.DATE, date) instead.
Sets the date to the given value. The other fields are only altered as necessary to match the same date and time on the new day of the month. In most cases, the other fields won't change at all. However, in the case of a leap second or the day being out of the range of the current month, values may be adjusted. For example, if the day of the month is currently 30 and the month is June, a new day of the month value of 31 will cause the month to change to July, as June only has 30 days . Similarly, a seconds value of 60 or 61 (a leap second) may result in the seconds value being reset to 0 and the minutes value being incremented by 1, if the new time does not include a leap second.Parameters: date the date.
Deprecated: Use Calendar instead of Date, and use set(Calendar.HOUR_OF_DAY, hours) instead.
Sets the hours to the given value. The other fields are only altered as necessary to match the same date and time in the new hour. In most cases, the other fields won't change at all. However, in the case of a leap second, values may be adjusted. For example, a seconds value of 60 or 61 (a leap second) may result in the seconds value being reset to 0 and the minutes value being incremented by 1 if the new hour does not contain a leap second.Parameters: hours the hours.
Deprecated: Use Calendar instead of Date, and use set(Calendar.MINUTE, minutes) instead.
Sets the minutes to the given value. The other fields are only altered as necessary to match the same date and time in the new minute. In most cases, the other fields won't change at all. However, in the case of a leap second, values may be adjusted. For example, a seconds value of 60 or 61 (a leap second) may result in the seconds value being reset to 0 and the minutes value being incremented by 1 if the new minute does not contain a leap second.Parameters: minutes the minutes.
See Also: Calendar getMinutes
Deprecated: Use Calendar instead of Date, and use set(Calendar.MONTH, month) instead.
Sets the month to the given value. The other fields are only altered as necessary to match the same date and time in the new month. In most cases, the other fields won't change at all. However, in the case of a shorter month or a leap second, values may be adjusted. For example, if the day of the month is currently 31, and the month value is changed from January (0) to September (8), the date will become October the 1st, as September only has 30 days. Similarly, a seconds value of 60 or 61 (a leap second) may result in the seconds value being reset to 0 and the minutes value being incremented by 1, if the new time does not include a leap second.Parameters: month the month, with a zero-based index from January.
Deprecated: Use Calendar instead of Date, and use set(Calendar.SECOND, seconds) instead.
Sets the seconds to the given value. The other fields are only altered as necessary to match the same date and time in the new minute. In most cases, the other fields won't change at all. However, in the case of a leap second, values may be adjusted. For example, setting the seconds value to 60 or 61 (a leap second) may result in the seconds value being reset to 0 and the minutes value being incremented by 1, if the current time does not contain a leap second.Parameters: seconds the seconds.
See Also: Calendar getSeconds
Parameters: time the time in milliseconds since the epoch.
Deprecated: Use Calendar instead of Date, and use set(Calendar.YEAR, year) instead. Note about the 1900 difference in year.
Sets the year to the specified year, plus 1900. The other fields are only altered as required to match the same date and time in the new year. Usually, this will mean that the fields are not changed at all, but in the case of a leap day or leap second, the fields will change in relation to the existence of such an event in the new year. For example, if the date specifies February the 29th, 2000, then this will become March the 1st if the year is changed to 2001, as 2001 is not a leap year. Similarly, a seconds value of 60 or 61 may result in the seconds becoming 0 and the minute increasing by 1, if the new time does not include a leap second.Parameters: year the year minus 1900.
Deprecated: Use DateFormat.format(Date) with a GMT TimeZone.
Returns a string representation of this Date
object using GMT rather than the local timezone.
The following date format is used:
d mon yyyy hh:mm:ss GMT
where the fields used here are:
d -- the day of the month
as one or two decimal digits (1 to 31).
mon -- the month (Jan to Dec).
yyyy -- the year as four decimal digits.
hh -- the hour of the day
as two decimal digits in 24-hour clock notation
(01 to 23).
mm -- the minute of the day
as two decimal digits (01 to 59).
ss -- the second of the day
as two decimal digits (01 to 61).
GMT -- the literal string "GMT"
indicating Greenwich Mean Time as opposed to
the local timezone.
Returns: A string of the form 'd mon yyyy hh:mm:ss GMT' using GMT as opposed to the local timezone.
See Also: parse DateFormat
Deprecated: Use DateFormat.format(Date)
Returns a locale-dependent string representation of thisDate object.
Returns: A locale-dependent string representation.
See Also: parse DateFormat
Returns a string representation of this date using the following date format:
day mon dd hh:mm:ss zz yyyy
where the fields used here are:
day -- the day of the week
(Sunday through to Saturday).
mon -- the month (Jan to Dec).
dd -- the day of the month
as two decimal digits (01 to 31).
hh -- the hour of the day
as two decimal digits in 24-hour clock notation
(01 to 23).
mm -- the minute of the day
as two decimal digits (01 to 59).
ss -- the second of the day
as two decimal digits (01 to 61).
zz -- the time zone information if available.
The possible time zones used include the abbreviations
recognised by parse() (e.g. GMT, CET, etc.)
and may reflect the fact that daylight savings time is in
effect. The empty string is used if there is no time zone
information.
yyyy -- the year as four decimal digits.
The DateFormat class should now be
preferred over using this method.
Returns: A string of the form 'day mon dd hh:mm:ss zz yyyy'
See Also: parse DateFormat
Deprecated: Use Calendar with a UTC
TimeZone instead.
Parameters: year the difference between the required year and 1900. month the month as a value between 0 and 11. date the day as a value between 0 and 31. hrs the hour as a value between 0 and 23, in 24-hour clock notation. min the minute as a value between 0 and 59. sec the second as a value between 0 and 61 (with 60 and 61 being leap seconds).
Returns: the time in milliseconds since the epoch.