org.dstadler.commons.date

Class DateParser

java.lang.Object

org.dstadler.commons.date.DateParser

public class DateParser
extends java.lang.Object

Modelled after http://graphite.readthedocs.org/en/latest/render_api.html#from-until Note: Passing in absolute time is expected to be stated in the European timezone!

Field Summary

Fields

Modifier and Type	Field and Description
static long	ONE_DAY
static long	ONE_HOUR
static long	ONE_MINUTE
static long	ONE_SECOND

Constructor Summary

Constructors

Constructor and Description
DateParser()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	computeTimeAgoString(long ts, java.lang.String suffix) Takes the time in milliseconds since the epoch and converts it into a string of "x days/hours/minutes/seconds" compared to the current time.
static java.util.Date	parseURLDate(java.lang.String dateStr, java.util.Date defaultDate)
static java.lang.String	timeToReadable(long millis) Format the given number of milliseconds as readable string.
static java.lang.String	timeToReadable(long millis, java.lang.String suffix) Format the given number of milliseconds as readable string, optionally appending a suffix.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ONE_SECOND

public static final long ONE_SECOND

See Also:

Constant Field Values

ONE_MINUTE

public static final long ONE_MINUTE

See Also:

Constant Field Values

ONE_HOUR

public static final long ONE_HOUR

See Also:

Constant Field Values

ONE_DAY

public static final long ONE_DAY

See Also:

Constant Field Values

Constructor Detail

DateParser

public DateParser()

Method Detail

parseURLDate

public static java.util.Date parseURLDate(java.lang.String dateStr,
                                          java.util.Date defaultDate)

computeTimeAgoString

public static java.lang.String computeTimeAgoString(long ts,
                                                    java.lang.String suffix)

Takes the time in milliseconds since the epoch and converts it into a string of "x days/hours/minutes/seconds" compared to the current time.

Parameters:

ts - The timestamp in milliseconds since the epoch

suffix - Some text that is appended only if there is a time-difference, i.e. it is not appended when the time is now.

Returns:

A readable string with a short description of how long ago the ts was.

timeToReadable

public static java.lang.String timeToReadable(long millis)

Format the given number of milliseconds as readable string.

Parameters:

millis - The number of milliseconds to print.

Returns:

The readable string.

timeToReadable

public static java.lang.String timeToReadable(long millis,
                                              java.lang.String suffix)

Format the given number of milliseconds as readable string, optionally appending a suffix.

Parameters:

millis - The number of milliseconds to print.

suffix - A suffix that is appended if the millis is > 0, specify "" if not needed.

Returns:

The readable string