com.aimpulse.time

Class Timestamps

java.lang.Object

com.aimpulse.time.Timestamps

public class Timestamps
extends Object

Utility class for working with timestamps, such as human-readable text outputs and extraction of components such as minutes.

Since:

1.3.0

Author:

Aimpulse

Method Summary

Methods

Modifier and Type	Method and Description
static int	hourOfDay(Timestamp time) Returns the hour of day for the given timestamp in UTC timezone.
static int	millisOfSecond(Timestamp time) Returns the milliseconds within the second for the given timestamp in UTC timezone.
static int	minuteOfHour(Timestamp time) Returns the minute within the hour for the given timestamp in UTC timezone.
static int	secondOfMinute(Timestamp time) Returns the second within the minute for the given timestamp in UTC timezone.
static String	toISODateString(Timestamp time) Formats the given timestamp date according to ISO 8601 standard without time of day.
static String	toISOString(Timestamp time) Formats the given timestamp date according to ISO 8601 standard with time of day applying UTC time zone.

Methods inherited from class java.lang.Object

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

Method Detail

hourOfDay

public static final int hourOfDay(Timestamp time)

Returns the hour of day for the given timestamp in UTC timezone.

Parameters:

time - The timestamp.

Returns:

The hour of day.

minuteOfHour

public static final int minuteOfHour(Timestamp time)

Returns the minute within the hour for the given timestamp in UTC timezone.

Parameters:

time - The timestamp.

Returns:

The minute within the timestamp's hour of day.

secondOfMinute

public static final int secondOfMinute(Timestamp time)

Returns the second within the minute for the given timestamp in UTC timezone.

Parameters:

time - The timestamp.

Returns:

The second within the minute.

millisOfSecond

public static final int millisOfSecond(Timestamp time)

Returns the milliseconds within the second for the given timestamp in UTC timezone.

Parameters:

time - The timestamp.

Returns:

The milliseconds within the second.

toISODateString

public static final String toISODateString(Timestamp time)

Formats the given timestamp date according to ISO 8601 standard without time of day. The format uses pattern "YYYY-MM-DD". For instance, all timestamps of May 1st in 2012 will be formatted as "2012-05-01". The reference time zone is UTC.

Parameters:

time - The timestamp to be formatted.

Returns:

Timestamp text representation according to ISO 8601.

toISOString

public static String toISOString(Timestamp time)

Formats the given timestamp date according to ISO 8601 standard with time of day applying UTC time zone. The format uses pattern "YYYY-MM-DDThh:mm:ssZ" with "hh" as the hours in 24 hour scheme (0-23) and "Z" for for the applied time zone UTC. The "second" component is omitted when 0. For instance, a timestamp during May 1st in 2012 could be formatted as "2012-05-01T17:25Z".

Parameters:

time - The timestamp to be formatted.

Returns:

Timestamp text representation according to ISO 8601 with time of day.