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:

java.io.Serializable, java.lang.Comparable<LongValue>

public final class Time
extends LongValue

An immutable Time class that represents a specific point in time. The underlying representation is a long value which holds a number of milliseconds since January 1, 1970, 0:00 GMT. To represent a duration of time, such as "6 seconds", use the Duration class. To represent a time period with a start and end time, use the TimeFrame class. To represent a time of day, use the TimeOfDay class.

Since:

1.2.6

Author:

Jonathan Locke

See Also:

Serialized Form

Field Summary

static Time

START_OF_UNIX_TIME the beginning of UNIX time: January 1, 1970, 0:00 GMT.

Fields inherited from class org.apache.wicket.util.value.LongValue

value

Method Summary

Time	add(Duration duration) Adds the given Duration to this Time object, moving the time into the future.
boolean	after(org.apache.wicket.util.time.AbstractTimeValue that) Returns true if this Time value is after the given Time argument's value.
boolean	before(org.apache.wicket.util.time.AbstractTimeValue that) Returns true if this Time value is before the given Time argument's value.
Duration	elapsedSince() Calculates the amount of time that has elapsed since this Time value.
Duration	fromNow() Retrieves the Duration from now to this Time value.
int	get(java.util.Calendar calendar, int field) Retrieves the value of a field from the given Calendar.
int	get(int field) Retrieves the value of a field.
int	getDayOfMonth() Retrieves the day of month field of the current Calendar.
int	getDayOfMonth(java.util.Calendar calendar) Retrieves the day of month field of the given Calendar.
int	getHour() Retrieves the hour field of the current Calendar.
int	getHour(java.util.Calendar calendar) Retrieves the hour field of the given Calendar.
long	getMilliseconds() Retrieves the number of milliseconds in this Time value.
int	getMinute() Retrieves the minute field of the current Calendar.
int	getMinute(java.util.Calendar calendar) Retrieves the minute field of the given Calendar.
int	getMonth() Retrieves the month field of the current Calendar.
int	getMonth(java.util.Calendar calendar) Retrieves the month field of the given Calendar.
int	getSecond() Retrieves the seconds field of the current Calendar.
int	getSecond(java.util.Calendar calendar) Retrieves the seconds field of the given Calendar.
int	getYear() Retrieves the year field of the current Calendar.
int	getYear(java.util.Calendar calendar) Retrieves the year field of the given Calendar.
static Time	milliseconds(long time) Retrieves a Time instance based on the given milliseconds.
static Time	now() Retrieves a Time instance based on the current time.
static Time	parseDate(java.util.Calendar calendar, java.lang.String string) Retrieves a Time instance by parsing 'yyyy.MM.dd' format.
static Time	parseDate(java.lang.String string) Retrieves a Time instance by parsing 'yyyy.MM.dd' format using a local time Calendar.
Time	subtract(Duration duration) Subtracts the given Duration from this Time object, moving the time into the past.
Duration	subtract(Time that) Subtract time from this and returns the difference as a Duration object.
java.util.Date	toDate() Retrieves a Date object for this Time object.
java.lang.String	toDateString() Converts this Time value to a date String using the date formatter 'yyyy.MM.dd'.
java.lang.String	toDateString(java.util.Calendar calendar) Converts this Time value to a date String using the formatter 'yyyy.MM.dd'.
java.lang.String	toString() Converts this Time value to a String suitable for use in a file system name.
java.lang.String	toString(java.util.Calendar calendar, java.lang.String format) Converts this Time object to a String using the given Calendar and format.
java.lang.String	toString(java.lang.String format) Converts this Time value to a String using the given format.
java.lang.String	toTimeString() Converts this Time to a time String using the formatter 'h.mma'.
java.lang.String	toTimeString(java.util.Calendar calendar) Converts this Time to a Date String using the Date formatter 'h.mma'.
static Time	valueOf(java.util.Calendar calendar, java.lang.String string) Retrieves a Time instance by parsing 'yyyy.MM.dd-h.mma' format.
static Time	valueOf(java.util.Calendar calendar, TimeOfDay timeOfDay) Retrieves a Time instance based on the given Calendar and TimeOfDay objects.
static Time	valueOf(java.util.Date date) Retrieves a Time instance based on the given Date object.
static Time	valueOf(long time) Retrieves a Time instance based on the given milliseconds.
static Time	valueOf(java.lang.String string) Retrieves a Time instance by parsing 'yyyy.MM.dd-h.mma' format.
static Time	valueOf(java.lang.String string, java.lang.String pattern) Retrieves a Time instance by parsing 'pattern' format.
static Time	valueOf(TimeOfDay timeOfDay) Retrieves a Time instance based on the given TimeOfDay object.

Methods inherited from class org.apache.wicket.util.value.LongValue

compareTo, equals, greaterThan, greaterThan, hashCode, lessThan, lessThan

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

START_OF_UNIX_TIME

public static final Time START_OF_UNIX_TIME

the beginning of UNIX time: January 1, 1970, 0:00 GMT.

Method Detail

milliseconds

public static Time milliseconds(long time)

Retrieves a Time instance based on the given milliseconds.

Parameters:

time - the time value in milliseconds since START_OF_UNIX_TIME

Returns:

the given Time

now

public static Time now()

Retrieves a Time instance based on the current time.

Returns:

the current Time

parseDate

public static Time parseDate(java.util.Calendar calendar,
                             java.lang.String string)
                      throws java.text.ParseException

Retrieves a Time instance by parsing 'yyyy.MM.dd' format.

Parameters:

calendar - the Calendar to use when parsing date String

string - the String to parse

Returns:

the time

Throws:

java.text.ParseException

parseDate

public static Time parseDate(java.lang.String string)
                      throws java.text.ParseException

Retrieves a Time instance by parsing 'yyyy.MM.dd' format using a local time Calendar.

Parameters:

string - the String to parse

Returns:

the time

Throws:

java.text.ParseException

valueOf

public static Time valueOf(java.util.Calendar calendar,
                           java.lang.String string)
                    throws java.text.ParseException

Retrieves a Time instance by parsing 'yyyy.MM.dd-h.mma' format.

Parameters:

calendar - the Calendar to use when parsing the String

string - the String to parse

Returns:

an immutable UNIX Time value

Throws:

java.text.ParseException

valueOf

public static Time valueOf(java.util.Calendar calendar,
                           TimeOfDay timeOfDay)

Retrieves a Time instance based on the given Calendar and TimeOfDay objects.

Parameters:

calendar - the Calendar to use

timeOfDay - the time of day

Returns:

a Time value for the time of day today

valueOf

public static Time valueOf(java.util.Date date)

Retrieves a Time instance based on the given Date object.

Parameters:

date - a java.util.Date object

Returns:

a corresponding immutable Time object

valueOf

public static Time valueOf(long time)

Retrieves a Time instance based on the given milliseconds.

Parameters:

time - the Time value in milliseconds since START_OF_UNIX_TIME

Returns:

a corresponding immutable Time object

valueOf

public static Time valueOf(java.lang.String string)
                    throws java.text.ParseException

Retrieves a Time instance by parsing 'yyyy.MM.dd-h.mma' format.

Parameters:

string - the String to parse

Returns:

the Time instance

Throws:

java.text.ParseException

valueOf

public static Time valueOf(java.lang.String string,
                           java.lang.String pattern)
                    throws java.text.ParseException

Retrieves a Time instance by parsing 'pattern' format.

Parameters:

string - input

pattern - the pattern to parse

Returns:

a Time instance that resulted from parsing the given String

Throws:

java.text.ParseException

valueOf

public static Time valueOf(TimeOfDay timeOfDay)

Retrieves a Time instance based on the given TimeOfDay object.

Parameters:

timeOfDay - the time of day in local time

Returns:

a Time value for the time of day today

add

public Time add(Duration duration)

Adds the given Duration to this Time object, moving the time into the future.

Parameters:

duration - the Duration to add

Returns:

this Time + Duration

elapsedSince

public Duration elapsedSince()

Calculates the amount of time that has elapsed since this Time value.

Returns:

the amount of time that has elapsed since this Time value

Throws:

java.lang.IllegalStateException - thrown if this Time value is in the future

fromNow

public Duration fromNow()

Retrieves the Duration from now to this Time value. If this Time value is in the past, then the Duration returned will be negative. Otherwise, it will be the number of milliseconds from now to this Time .

Returns:

the Duration from now to this Time value

get

public int get(java.util.Calendar calendar,
               int field)

Retrieves the value of a field from the given Calendar.

Parameters:

calendar - the Calendar to use

field - the Calendar field to get

Returns:

the field's value for this point in time on the given Calendar

get

public int get(int field)

Retrieves the value of a field.

Parameters:

field - the Calendar field to get

Returns:

the field's value (in local time)

getDayOfMonth

public int getDayOfMonth()

Retrieves the day of month field of the current Calendar.

Returns:

the day of month field value

getDayOfMonth

public int getDayOfMonth(java.util.Calendar calendar)

Retrieves the day of month field of the given Calendar.

Parameters:

calendar - the Calendar to get the field value from

Returns:

the day of month field value

getHour

public int getHour()

Retrieves the hour field of the current Calendar.

Returns:

the hour field value

getHour

public int getHour(java.util.Calendar calendar)

Retrieves the hour field of the given Calendar.

Parameters:

calendar - the Calendar to get the field value from

Returns:

the hour field value

getMinute

public int getMinute()

Retrieves the minute field of the current Calendar.

Returns:

the minute field value

getMinute

public int getMinute(java.util.Calendar calendar)

Retrieves the minute field of the given Calendar.

Parameters:

calendar - the Calendar from which to get the field value

Returns:

the minute field value

getMonth

public int getMonth()

Retrieves the month field of the current Calendar.

Returns:

the month field value

getMonth

public int getMonth(java.util.Calendar calendar)

Retrieves the month field of the given Calendar.

Parameters:

calendar - the Calendar from which to get the field value

Returns:

the month field value

getSecond

public int getSecond()

Retrieves the seconds field of the current Calendar.

Returns:

the seconds field value

getSecond

public int getSecond(java.util.Calendar calendar)

Retrieves the seconds field of the given Calendar.

Parameters:

calendar - the Calendar from which to get the field value

Returns:

the seconds field value

getYear

public int getYear()

Retrieves the year field of the current Calendar.

Returns:

the year field value

getYear

public int getYear(java.util.Calendar calendar)

Retrieves the year field of the given Calendar.

Parameters:

calendar - the Calendar from which to get the field value

Returns:

the year field value

subtract

public Time subtract(Duration duration)

Subtracts the given Duration from this Time object, moving the time into the past.

Parameters:

duration - the Duration to subtract

Returns:

this duration of time

subtract

public Duration subtract(Time that)

Subtract time from this and returns the difference as a Duration object.

Parameters:

that - the time to subtract

Returns:

the Duration between this and that time

toDate

public java.util.Date toDate()

Retrieves a Date object for this Time object. A new Date object is always returned rather than attempting to cache a date since Date is mutable.

Returns:

this immutable Time object as a mutable java.util.Date object

toDateString

public java.lang.String toDateString()

Converts this Time value to a date String using the date formatter 'yyyy.MM.dd'.

Returns:

the date string

toDateString

public java.lang.String toDateString(java.util.Calendar calendar)

Converts this Time value to a date String using the formatter 'yyyy.MM.dd'.

Parameters:

calendar - the Calendar to use in the conversion

Returns:

the date String

toString

public java.lang.String toString()

Converts this Time value to a String suitable for use in a file system name.

Returns:

this Time value as a formatted String

toString

public java.lang.String toString(java.util.Calendar calendar,
                                 java.lang.String format)

Converts this Time object to a String using the given Calendar and format.

Parameters:

calendar - the Calendar to use in the conversion

format - the format to use

Returns:

this Time value as a formatted String

toString

public java.lang.String toString(java.lang.String format)

Converts this Time value to a String using the given format.

Parameters:

format - the format to use

Returns:

this Time value as a formatted string

after

public final boolean after(org.apache.wicket.util.time.AbstractTimeValue that)

Returns true if this Time value is after the given Time argument's value.

Parameters:

that - the AbstractTimeValue to compare with

Returns:

true if this Time value is after that Time value

before

public final boolean before(org.apache.wicket.util.time.AbstractTimeValue that)

Returns true if this Time value is before the given Time argument's value.

Parameters:

that - the AbstractTimeValue to compare with

Returns:

true if this Time value is before that Time value

toTimeString

public final java.lang.String toTimeString()

Converts this Time to a time String using the formatter 'h.mma'.

Returns:

the Time String

toTimeString

public final java.lang.String toTimeString(java.util.Calendar calendar)

Converts this Time to a Date String using the Date formatter 'h.mma'.

Parameters:

calendar - the Calendar to use in the conversion

Returns:

the Date String

getMilliseconds

public final long getMilliseconds()

Retrieves the number of milliseconds in this Time value.

Returns:

the number of milliseconds in this Time value