Package org.apache.wicket.util.time
Class Time
- java.lang.Object
-
- org.apache.wicket.util.value.LongValue
-
- org.apache.wicket.util.time.Time
-
- All Implemented Interfaces:
Serializable,Comparable<LongValue>
@Deprecated public final class Time extends LongValue
Deprecated.Since Wicket 9 this class is obsolete and no more used. It will be removed in Wicket 10. UseInstantinsteadAn immutableTimeclass that represents a specific point in time. The underlying representation is alongvalue which holds a number of milliseconds since January 1, 1970, 0:00 GMT. To represent a duration of time, such as "6 seconds", use theDurationclass. To represent a time period with a start and end time, use theTimeFrameclass. To represent a time of day, use theTimeOfDayclass.- Since:
- 1.2.6
- Author:
- Jonathan Locke
- See Also:
- Serialized Form
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description Timeadd(Duration duration)Deprecated.Adds the givenDurationto thisTimeobject, moving the time into the future.booleanafter(org.apache.wicket.util.time.AbstractTimeValue that)Deprecated.Returnstrueif thisTimevalue is after the givenTimeargument's value.booleanbefore(org.apache.wicket.util.time.AbstractTimeValue that)Deprecated.Returnstrueif thisTimevalue is before the givenTimeargument's value.DurationelapsedSince()Deprecated.Calculates the amount of time that has elapsed since thisTimevalue.DurationfromNow()Deprecated.Retrieves theDurationfrom now to thisTimevalue.intget(int field)Deprecated.Retrieves the value of a field.intget(Calendar calendar, int field)Deprecated.Retrieves the value of a field from the givenCalendar.intgetDayOfMonth()Deprecated.Retrieves the day of month field of the currentCalendar.intgetDayOfMonth(Calendar calendar)Deprecated.Retrieves the day of month field of the givenCalendar.intgetHour()Deprecated.Retrieves the hour field of the currentCalendar.intgetHour(Calendar calendar)Deprecated.Retrieves the hour field of the givenCalendar.longgetMilliseconds()Deprecated.Retrieves the number of milliseconds in thisTimevalue.intgetMinute()Deprecated.Retrieves the minute field of the currentCalendar.intgetMinute(Calendar calendar)Deprecated.Retrieves the minute field of the givenCalendar.intgetMonth()Deprecated.Retrieves the month field of the currentCalendar.intgetMonth(Calendar calendar)Deprecated.Retrieves the month field of the givenCalendar.intgetSecond()Deprecated.Retrieves the seconds field of the currentCalendar.intgetSecond(Calendar calendar)Deprecated.Retrieves the seconds field of the givenCalendar.intgetYear()Deprecated.Retrieves the year field of the currentCalendar.intgetYear(Calendar calendar)Deprecated.Retrieves the year field of the givenCalendar.static Timemillis(long time)Deprecated.Retrieves aTimeinstance based on the given milliseconds.static Timenow()Deprecated.Retrieves aTimeinstance based on the current time.static TimeparseDate(String string)Deprecated.Retrieves aTimeinstance by parsing 'yyyy.MM.dd' format using a local timeCalendar.static TimeparseDate(Calendar calendar, String string)Deprecated.Retrieves aTimeinstance by parsing 'yyyy.MM.dd' format.Timesubtract(Duration duration)Deprecated.Subtracts the givenDurationfrom thisTimeobject, moving the time into the past.Durationsubtract(Time that)Deprecated.Subtract time from this and returns the difference as aDurationobject.DatetoDate()Deprecated.Retrieves aDateobject for thisTimeobject.StringtoDateString()Deprecated.Converts thisTimevalue to a dateStringusing the date formatter 'yyyy.MM.dd'.StringtoDateString(Calendar calendar)Deprecated.Converts thisTimevalue to a dateStringusing the formatter 'yyyy.MM.dd'.StringtoRfc1123TimestampString()Deprecated.Returns this time stamp in RFC1123 string format.StringtoString()Deprecated.Converts thisTimevalue to aStringsuitable for use in a file system name.StringtoString(String format)Deprecated.Converts thisTimevalue to aStringusing the given format.StringtoString(Calendar calendar, String format)Deprecated.Converts thisTimeobject to aStringusing the givenCalendarand format.StringtoTimeString()Deprecated.Converts thisTimeto a timeStringusing the formatter 'h.mma'.StringtoTimeString(Calendar calendar)Deprecated.Converts thisTimeto aDate Stringusing theDateformatter 'h.mma'.static TimevalueOf(String string)Deprecated.Retrieves aTimeinstance by parsing 'yyyy.MM.dd-h.mma' format.static TimevalueOf(String string, String pattern)Deprecated.Retrieves aTimeinstance by parsing 'pattern' format.static TimevalueOf(Calendar calendar, String string)Deprecated.Retrieves aTimeinstance by parsing 'yyyy.MM.dd-h.mma' format.static TimevalueOf(Calendar calendar, TimeOfDay timeOfDay)Deprecated.static TimevalueOf(Date date)Deprecated.Retrieves aTimeinstance based on the givenDateobject.static TimevalueOf(TimeOfDay timeOfDay)Deprecated.Retrieves aTimeinstance based on the givenTimeOfDayobject.-
Methods inherited from class org.apache.wicket.util.value.LongValue
compareTo, equals, greaterThan, greaterThan, greaterThanOrEqual, greaterThanOrEqual, hashCode, lessThan, lessThan, lessThanOrEqual, lessThanOrEqual, max, maxNullSafe, min
-
-
-
-
Field Detail
-
START_OF_UNIX_TIME
public static final Time START_OF_UNIX_TIME
Deprecated.the beginning of UNIX time: January 1, 1970, 0:00 GMT.
-
-
Method Detail
-
now
public static Time now()
Deprecated.Retrieves aTimeinstance based on the current time.- Returns:
- the current
Time
-
millis
public static Time millis(long time)
Deprecated.Retrieves aTimeinstance based on the given milliseconds.- Parameters:
time- theTimevalue in milliseconds since START_OF_UNIX_TIME- Returns:
- a corresponding immutable
Timeobject
-
parseDate
public static Time parseDate(Calendar calendar, String string) throws ParseException
Deprecated.Retrieves aTimeinstance by parsing 'yyyy.MM.dd' format.- Parameters:
calendar- theCalendarto use when parsing dateStringstring- theStringto parse- Returns:
- the time
- Throws:
ParseException
-
parseDate
public static Time parseDate(String string) throws ParseException
Deprecated.Retrieves aTimeinstance by parsing 'yyyy.MM.dd' format using a local timeCalendar.- Parameters:
string- theStringto parse- Returns:
- the time
- Throws:
ParseException
-
valueOf
public static Time valueOf(Calendar calendar, String string) throws ParseException
Deprecated.Retrieves aTimeinstance by parsing 'yyyy.MM.dd-h.mma' format.- Parameters:
calendar- theCalendarto use when parsing theStringstring- theStringto parse- Returns:
- an immutable UNIX
Timevalue - Throws:
ParseException
-
valueOf
public static Time valueOf(Calendar calendar, TimeOfDay timeOfDay)
Deprecated.- Parameters:
calendar- theCalendarto usetimeOfDay- the time of day- Returns:
- a
Timevalue for the time of day today
-
valueOf
public static Time valueOf(Date date)
Deprecated.Retrieves aTimeinstance based on the givenDateobject.- Parameters:
date- ajava.util.Dateobject- Returns:
- a corresponding immutable
Timeobject
-
valueOf
public static Time valueOf(String string) throws ParseException
Deprecated.Retrieves aTimeinstance by parsing 'yyyy.MM.dd-h.mma' format.- Parameters:
string- theStringto parse- Returns:
- the
Timeinstance - Throws:
ParseException
-
valueOf
public static Time valueOf(String string, String pattern) throws ParseException
Deprecated.Retrieves aTimeinstance by parsing 'pattern' format.- Parameters:
string- inputpattern- the pattern to parse- Returns:
- a
Timeinstance that resulted from parsing the givenString - Throws:
ParseException
-
valueOf
public static Time valueOf(TimeOfDay timeOfDay)
Deprecated.Retrieves aTimeinstance based on the givenTimeOfDayobject.- Parameters:
timeOfDay- the time of day in local time- Returns:
- a
Timevalue for the time of day today
-
add
public Time add(Duration duration)
Deprecated.Adds the givenDurationto thisTimeobject, moving the time into the future.- Parameters:
duration- theDurationto add- Returns:
- this
Time+Duration
-
elapsedSince
public Duration elapsedSince()
Deprecated.Calculates the amount of time that has elapsed since thisTimevalue.- Returns:
- the amount of time that has elapsed since this
Timevalue - Throws:
IllegalStateException- thrown if thisTimevalue is in the future
-
fromNow
public Duration fromNow()
Deprecated.Retrieves theDurationfrom now to thisTimevalue. If thisTimevalue is in the past, then theDurationreturned will be negative. Otherwise, it will be the number of milliseconds from now to thisTime.- Returns:
- the
Durationfrom now to thisTimevalue
-
get
public int get(Calendar calendar, int field)
Deprecated.Retrieves the value of a field from the givenCalendar.- Parameters:
calendar- theCalendarto usefield- theCalendarfield to get- Returns:
- the field's value for this point in time on the given
Calendar
-
get
public int get(int field)
Deprecated.Retrieves the value of a field.- Parameters:
field- theCalendarfield to get- Returns:
- the field's value (in local time)
-
getDayOfMonth
public int getDayOfMonth()
Deprecated.Retrieves the day of month field of the currentCalendar.- Returns:
- the day of month field value
-
getDayOfMonth
public int getDayOfMonth(Calendar calendar)
Deprecated.Retrieves the day of month field of the givenCalendar.- Parameters:
calendar- theCalendarto get the field value from- Returns:
- the day of month field value
-
getHour
public int getHour()
Deprecated.Retrieves the hour field of the currentCalendar.- Returns:
- the hour field value
-
getHour
public int getHour(Calendar calendar)
Deprecated.Retrieves the hour field of the givenCalendar.- Parameters:
calendar- theCalendarto get the field value from- Returns:
- the hour field value
-
getMinute
public int getMinute()
Deprecated.Retrieves the minute field of the currentCalendar.- Returns:
- the minute field value
-
getMinute
public int getMinute(Calendar calendar)
Deprecated.Retrieves the minute field of the givenCalendar.- Parameters:
calendar- theCalendarfrom which to get the field value- Returns:
- the minute field value
-
getMonth
public int getMonth()
Deprecated.Retrieves the month field of the currentCalendar.- Returns:
- the month field value
-
getMonth
public int getMonth(Calendar calendar)
Deprecated.Retrieves the month field of the givenCalendar.- Parameters:
calendar- theCalendarfrom which to get the field value- Returns:
- the month field value
-
getSecond
public int getSecond()
Deprecated.Retrieves the seconds field of the currentCalendar.- Returns:
- the seconds field value
-
getSecond
public int getSecond(Calendar calendar)
Deprecated.Retrieves the seconds field of the givenCalendar.- Parameters:
calendar- theCalendarfrom which to get the field value- Returns:
- the seconds field value
-
getYear
public int getYear()
Deprecated.Retrieves the year field of the currentCalendar.- Returns:
- the year field value
-
getYear
public int getYear(Calendar calendar)
Deprecated.Retrieves the year field of the givenCalendar.- Parameters:
calendar- theCalendarfrom which to get the field value- Returns:
- the year field value
-
subtract
public Time subtract(Duration duration)
Deprecated.Subtracts the givenDurationfrom thisTimeobject, moving the time into the past.- Parameters:
duration- theDurationto subtract- Returns:
- this duration of time
-
subtract
public Duration subtract(Time that)
Deprecated.Subtract time from this and returns the difference as aDurationobject.- Parameters:
that- the time to subtract- Returns:
- the
Durationbetween this and that time
-
toDate
public Date toDate()
Deprecated.Retrieves aDateobject for thisTimeobject. A newDateobject is always returned rather than attempting to cache a date sinceDateis mutable.- Returns:
- this immutable
Timeobject as a mutablejava.util.Dateobject
-
toDateString
public String toDateString()
Deprecated.Converts thisTimevalue to a dateStringusing the date formatter 'yyyy.MM.dd'.- Returns:
- the date string
-
toDateString
public String toDateString(Calendar calendar)
Deprecated.Converts thisTimevalue to a dateStringusing the formatter 'yyyy.MM.dd'.- Parameters:
calendar- theCalendarto use in the conversion- Returns:
- the date
String
-
toString
public String toString()
Deprecated.Converts thisTimevalue to aStringsuitable for use in a file system name.- Returns:
- this
Timevalue as a formattedString
-
toString
public String toString(Calendar calendar, String format)
Deprecated.Converts thisTimeobject to aStringusing the givenCalendarand format.- Parameters:
calendar- theCalendarto use in the conversionformat- the format to use- Returns:
- this
Timevalue as a formattedString
-
toString
public String toString(String format)
Deprecated.Converts thisTimevalue to aStringusing the given format.- Parameters:
format- the format to use- Returns:
- this
Timevalue as a formatted string
-
toRfc1123TimestampString
public String toRfc1123TimestampString()
Deprecated.Returns this time stamp in RFC1123 string format. Contrary toSimpleDateFormatthis is thread-safe. Taken from the source code of jetty 7.3.0, credits + thanks to Greg Wilkins!- Returns:
- timestamp string in RFC1123 format
-
after
public final boolean after(org.apache.wicket.util.time.AbstractTimeValue that)
Deprecated.Returnstrueif thisTimevalue is after the givenTimeargument's value.- Parameters:
that- theAbstractTimeValueto compare with- Returns:
trueif thisTimevalue is afterthatTimevalue
-
before
public final boolean before(org.apache.wicket.util.time.AbstractTimeValue that)
Deprecated.Returnstrueif thisTimevalue is before the givenTimeargument's value.- Parameters:
that- theAbstractTimeValueto compare with- Returns:
trueif thisTimevalue is beforethatTimevalue
-
toTimeString
public final String toTimeString()
Deprecated.Converts thisTimeto a timeStringusing the formatter 'h.mma'.- Returns:
- the
TimeString
-
toTimeString
public final String toTimeString(Calendar calendar)
Deprecated.Converts thisTimeto aDate Stringusing theDateformatter 'h.mma'.- Parameters:
calendar- theCalendarto use in the conversion- Returns:
- the
DateString
-
getMilliseconds
public final long getMilliseconds()
Deprecated.Retrieves the number of milliseconds in thisTimevalue.- Returns:
- the number of milliseconds in this
Timevalue
-
-