com.sun.identity.shared

Class DateUtils

java.lang.Object

com.sun.identity.shared.DateUtils

public class DateUtils
extends Object

This class provides utility to perform date conversion.

Constructor Summary

Constructors

Constructor and Description
DateUtils()

Method Summary

Modifier and Type	Method and Description
static String	dateToString(Date date) Returns yyyy-MM-dd HH:mm:ss String representation of a date.
static Date	stringToDate(String strDate) Returns date that is represented by a string.
static String	toFullLocalDateFormat(Date date) Returns ISO-8601 (RFC3339) compatible representation of local date and time and time offset.
static String	toUTCDateFormat(Date date) Returns UTC String representation of a date.
static String	toUTCDateFormatWithMilliseconds(Date date) Returns UTC String representation of a date with milliseconds.

Methods inherited from class java.lang.Object

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

Constructor Detail

DateUtils

public DateUtils()

Method Detail

dateToString

public static String dateToString(Date date)

Returns yyyy-MM-dd HH:mm:ss String representation of a date.

Parameters:

date - Date object.

Returns:

The formatted date.

toUTCDateFormat

public static String toUTCDateFormat(Date date)

Returns UTC String representation of a date. For instance, 2004-03-20T05:53:32Z.

Parameters:

date - Date object.

Returns:

The formatted date.

toUTCDateFormatWithMilliseconds

public static String toUTCDateFormatWithMilliseconds(Date date)

Returns UTC String representation of a date with milliseconds. For instance, 2004-03-20T05:53:32.321Z.

Parameters:

date - Date object.

Returns:

The formatted date.

toFullLocalDateFormat

public static String toFullLocalDateFormat(Date date)

Returns ISO-8601 (RFC3339) compatible representation of local date and time and time offset. For instance, 2004-03-20T07:53:32+02:00.

Parameters:

date - Date object.

Returns:

The formatted date.

stringToDate

public static Date stringToDate(String strDate)
                         throws ParseException

Returns date that is represented by a string. It uses the following representation of date. yyyy-MM-DD'T'hh:mm:ss based on the following definition of "dateTime" attribute in XML schema which can be found at http://www.w3.org/TR/xmlschema-2/#dateTime. A single lexical representation, which is a subset of the lexical representations allowed by [ISO 8601], is allowed for dateTime. This lexical representation is the [ISO 8601] extended format CCYY-MM-DDThh:mm:ss where "CC" represents the century, "YY" the year, "MM" the month and "DD" the day, preceded by an optional leading "-" sign to indicate a negative number. If the sign is omitted, "+" is assumed. The letter "T" is the date/time separator and "hh", "mm", "ss" represent hour, minute and second respectively. Additional digits can be used to increase the precision of fractional seconds if desired i.e the format ss.ss... with any number of digits after the decimal point is supported. The fractional seconds part is optional; other parts of the lexical form are not optional. To accommodate year values greater than 9999 additional digits can be added to the left of this representation. Leading zeros are required if the year value would otherwise have fewer than four digits; otherwise they are forbidden. The year 0000 is prohibited. The CCYY field must have at least four digits, the MM, DD, SS, hh, mm and ss fields exactly two digits each (not counting fractional seconds); leading zeroes must be used if the field would otherwise have too few digits. This representation may be immediately followed by a "Z" to indicate Coordinated Universal Time (UTC) or, to indicate the time zone, i.e. the difference between the local time and Coordinated Universal Time, immediately followed by a sign, + or -, followed by the difference from UTC represented as hh:mm (note: the minutes part is required). See ISO 8601 Date and Time Formats ('D) for details about legal values in the various fields. If the time zone is included, both hours and minutes must be present. For example, to indicate 1:20 pm on May the 31st, 1999 for Eastern Standard Time which is 5 hours behind Coordinated Universal Time (UTC), one would write: 1999-05-31T13:20:00-05:00.

Parameters:

strDate - String representation of date.

Throws:

ParseException - if strDate is in an invalid format.