ISO8601DateFormat (Alfresco 5.0.3 Public API)

Class ISO8601DateFormat

org.alfresco.util.ISO8601DateFormat

public class ISO8601DateFormat

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
ISO8601DateFormat()

Method Summary
static String	format(Date isoDate) Format date into ISO format (UCT0 / Zulu)
static String	formatToZulu(String isoDate) Normalise isoDate time to Zulu(UTC0) time-zone, removing any UTC offset.
static Calendar	getCalendar() Get a calendar object from cache.
static boolean	isTimeComponentDefined(String isoDate) Checks whether or not the given ISO8601-formatted date-string contains a time-component instead of only the actual date.
static Date	parse(String isoDate) Parse date from ISO formatted string.
static Date	parse(String isoDate, TimeZone timezone) Parse date from ISO formatted string, with an explicit timezone specified
static Date	parseDayOnly(String isoDate, TimeZone timezone) Parses the given ISO8601-formatted date-string, not taking into account the time-component.
static Date	parseInternal(String isoDate, 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

public ISO8601DateFormat()

public static Calendar getCalendar()

Get a calendar object from cache.

calendar object from cache or newly created (if cache is empty)

public static String format(Date isoDate)

Format date into ISO format (UCT0 / Zulu)

isoDate - the date to format

the ISO Zulu timezone formatted string

public static String formatToZulu(String isoDate)

Normalise isoDate time to Zulu(UTC0) time-zone, removing any UTC offset.

the ISO Zulu timezone formatted string e.g 2011-02-04T17:13:14.000+01:00 -> 2011-02-04T16:13:14.000Z

public static Date parse(String isoDate)

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

isoDate - ISO string to parse

public static Date parse(String isoDate,
TimeZone timezone)

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

isoDate - ISO string to parse

timezone - The TimeZone the date is in

public static Date parseInternal(String isoDate,
TimeZone timezone)

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

isoDate - ISO string to parse

timezone - The time zone, null means default time zone

isTimeComponentDefined

public static boolean isTimeComponentDefined(String isoDate)

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

true, if time is present.

public static Date parseDayOnly(String isoDate,
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.

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

timezone - the timezone to use

AlfrescoRuntimeException - if the parsing failed.

Java API documentation generated with DocFlex/Javadoc 1.6.1 using JavadocPro template set.