org.alfresco.util

Class ISO8601DateFormat

java.lang.Object

org.alfresco.util.ISO8601DateFormat

public class ISO8601DateFormat
extends java.lang.Object

Formatting support for ISO 8601 dates

    sYYYY-MM-DDThh:mm:ss.sssTZD
 

where:

• sYYYY Four-digit year with optional leading positive (+) or negative (-) sign. A negative sign indicates a year BCE. The absence of a sign or the presence of a positive sign indicates a year CE (for example, -0055 would indicate the year 55 BCE, while +1969 and 1969 indicate the year 1969 CE).
• MM Two-digit month (01 = January, etc.)
• DD Two-digit day of month (01 through 31)
• hh Two digits of hour (00 through 23)
• mm Two digits of minute (00 through 59)
• ss.sss Seconds, to three decimal places (00.000 through 59.999)
• TZD Time zone designator (either Z for Zulu, i.e. UTC, or +hh:mm or -hh:mm, i.e. an offset from UTC)

Constructor Summary

Constructors

Constructor and Description
ISO8601DateFormat()

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	format(java.util.Date isoDate) Format date into ISO format
static boolean	isTimeComponentDefined(java.lang.String isoDate) Checks whether or not the given ISO8601-formatted date-string contains a time-component instead of only the actual date.
static java.util.Date	parse(java.lang.String isoDate) Parse date from ISO formatted string.
static java.util.Date	parse(java.lang.String isoDate, java.util.TimeZone timezone) Parse date from ISO formatted string, with an explicit timezone specified
static java.util.Date	parseDayOnly(java.lang.String isoDate, java.util.TimeZone timezone) Parses the given ISO8601-formatted date-string, not taking into account the time-component.
static java.util.Date	parseInternal(java.lang.String isoDate, java.util.TimeZone timezone) Parse date from ISO formatted string, either in the specified TimeZone, or with TimeZone information taken from the date

Methods inherited from class java.lang.Object

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

Constructor Detail

ISO8601DateFormat

public ISO8601DateFormat()

Method Detail

format

public static java.lang.String format(java.util.Date isoDate)

Format date into ISO format

Parameters:

isoDate - the date to format

Returns:

the ISO formatted string

parse

public static java.util.Date parse(java.lang.String isoDate)

Parse date from ISO formatted string. The ISO8601 date must include TimeZone offset information

Parameters:

isoDate - ISO string to parse

Returns:

the date

Throws:

AlfrescoRuntimeException - if the parse failed

parse

public static java.util.Date parse(java.lang.String isoDate,
                   java.util.TimeZone timezone)

Parse date from ISO formatted string, with an explicit timezone specified

Parameters:

isoDate - ISO string to parse

timezone - The TimeZone the date is in

Returns:

the date

Throws:

AlfrescoRuntimeException - if the parse failed

parseInternal

public static java.util.Date parseInternal(java.lang.String isoDate,
                           java.util.TimeZone timezone)

Parse date from ISO formatted string, either in the specified TimeZone, or with TimeZone information taken from the date

Parameters:

isoDate - ISO string to parse

Returns:

the date

Throws:

AlfrescoRuntimeException - if the parse failed

isTimeComponentDefined

public static boolean isTimeComponentDefined(java.lang.String isoDate)

Checks whether or not the given ISO8601-formatted date-string contains a time-component instead of only the actual date.

Parameters:

isoDate -

Returns:

true, if time is present.

parseDayOnly

public static java.util.Date parseDayOnly(java.lang.String isoDate,
                          java.util.TimeZone timezone)

Parses the given ISO8601-formatted date-string, not taking into account the time-component. The time-information for the will be reset to zero.

Parameters:

isoDate - the day (formatted sYYYY-MM-DD) or a full date (sYYYY-MM-DDThh:mm:ss.sssTZD)

timeZone - the timezone to use

Returns:

the parsed date

Throws:

AlfrescoRuntimeException - if the parsing failed.