org.dynamide.util

Class GregorianCalendarDateTimeUtils

java.lang.Object

org.dynamide.util.GregorianCalendarDateTimeUtils

public class GregorianCalendarDateTimeUtils
extends Object

Constructor Summary

Constructors

Constructor and Description
GregorianCalendarDateTimeUtils()

Method Summary

Modifier and Type	Method and Description
static GregorianCalendar	currentDateAndTime(TimeZone tz) Returns a calendar date, representing the current date and time instance in the specified time zone.
static GregorianCalendar	currentDateAndTimeUTC() Returns a calendar date, representing the current date and time instance in the UTC time zone.
static String	currentDateUTC() Returns a String representing the current date and time instance.
static String	dateUTCToString(Object millis)
static String	formatAsISO8601Date(GregorianCalendar cal) Returns a representation of a calendar date and time instance, as an ISO 8601-formatted date.
static String	formatAsISO8601Timestamp(GregorianCalendar cal) Returns a representation of a calendar date and time instance, as an ISO 8601-formatted timestamp in the UTC time zone.
static String	formatGregorianCalendarDate(GregorianCalendar gcal, DateFormat df) Formats a provided calendar date using a supplied date formatter, in the default system time zone.
static String	formatGregorianCalendarDate(GregorianCalendar gcal, TimeZone tz, DateFormat df) Formats a provided calendar date using a provided date formatter, in a provided time zone.
static String	timestampUTC() Returns a String representing the current date and time instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

GregorianCalendarDateTimeUtils

public GregorianCalendarDateTimeUtils()

Method Detail

timestampUTC

public static String timestampUTC()

Returns a String representing the current date and time instance. in the UTC time zone, formatted as an ISO 8601 timestamp.

Returns:

A String representing the current date and time instance.

currentDateUTC

public static String currentDateUTC()

Returns a String representing the current date and time instance. in the UTC time zone, formatted as an ISO 8601 date.

Returns:

A String representing the current date and time instance.

dateUTCToString

public static String dateUTCToString(Object millis)

currentDateAndTimeUTC

public static GregorianCalendar currentDateAndTimeUTC()

Returns a calendar date, representing the current date and time instance in the UTC time zone.

Returns:

The current date and time instance in the UTC time zone.

currentDateAndTime

public static GregorianCalendar currentDateAndTime(TimeZone tz)

Returns a calendar date, representing the current date and time instance in the specified time zone.

Returns:

The current date and time instance in the specified time zone. If the time zone is null, will return the current time and date in the time zone intrinsic to a new Calendar instance.

formatAsISO8601Timestamp

public static String formatAsISO8601Timestamp(GregorianCalendar cal)

Returns a representation of a calendar date and time instance, as an ISO 8601-formatted timestamp in the UTC time zone.

Parameters:

cal - a calendar date and time instance.

Returns:

a representation of that calendar date and time instance, as an ISO 8601-formatted timestamp in the UTC time zone.

formatAsISO8601Date

public static String formatAsISO8601Date(GregorianCalendar cal)

Returns a representation of a calendar date and time instance, as an ISO 8601-formatted date.

Parameters:

cal - a calendar date and time instance.

Returns:

a representation of that calendar date and time instance, as an ISO 8601-formatted date.

formatGregorianCalendarDate

public static String formatGregorianCalendarDate(GregorianCalendar gcal,
                                                 DateFormat df)

Formats a provided calendar date using a supplied date formatter, in the default system time zone.

Parameters:

gcal - A GregorianCalendar date to format.

df - A date formatter to apply.

Returns:

A formatted date string, or the empty string if one or more of the parameter values were invalid.

formatGregorianCalendarDate

public static String formatGregorianCalendarDate(GregorianCalendar gcal,
                                                 TimeZone tz,
                                                 DateFormat df)

Formats a provided calendar date using a provided date formatter, in a provided time zone.

Parameters:

gcal - A GregorianCalendar date to format.

tz - The time zone qualifier for the calendar date to format.

df - A date formatter to apply.

Returns:

A formatted date string, or the empty string if one or more of the parameter values were invalid.