net.yacy.cora.date

Class ISO8601Formatter

java.lang.Object

net.yacy.cora.date.AbstractFormatter

net.yacy.cora.date.ISO8601Formatter

All Implemented Interfaces:

DateFormatter

public class ISO8601Formatter
extends AbstractFormatter
implements DateFormatter

Field Summary

Fields

Modifier and Type	Field and Description
private static java.text.SimpleDateFormat	FORMAT_ISO8601 Date formatter/non-sloppy parser for W3C datetime (ISO8601) in GMT/UTC
static ISO8601Formatter	FORMATTER
private static java.lang.String	PATTERN_ISO8601 pattern for a W3C datetime variant of a non-localized ISO8601 date

Fields inherited from class net.yacy.cora.date.AbstractFormatter

dayMillis, hourMillis, last_format, last_time, leapyearMillis, minuteMillis, monthAverageMillis, normalyearMillis, secondMillis, testCalendar, UTCCalendar, UTCtimeZone

Constructor Summary

Constructors

Constructor and Description
ISO8601Formatter()

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	format()
java.lang.String	format(java.util.Date date) Creates a String representation of a Date using the format defined in ISO8601/W3C datetime The result will be in UTC/GMT, e.g.
java.util.Calendar	parse(java.lang.String s, int timezoneOffset) Parse dates as defined in http://www.w3.org/TR/NOTE-datetime.

Methods inherited from class java.lang.Object

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

Field Detail

PATTERN_ISO8601

private static final java.lang.String PATTERN_ISO8601

pattern for a W3C datetime variant of a non-localized ISO8601 date

See Also:

Constant Field Values

FORMAT_ISO8601

private static final java.text.SimpleDateFormat FORMAT_ISO8601

Date formatter/non-sloppy parser for W3C datetime (ISO8601) in GMT/UTC

FORMATTER

public static final ISO8601Formatter FORMATTER

Constructor Detail

ISO8601Formatter

public ISO8601Formatter()

Method Detail

parse

public java.util.Calendar parse(java.lang.String s,
                       int timezoneOffset)
                         throws java.text.ParseException

Parse dates as defined in http://www.w3.org/TR/NOTE-datetime. This format (also specified in ISO8601) allows different "precisions". The following lower precision versions for the complete date "2007-12-19T10:20:30.567+0300" are allowed:
"2007"
"2007-12"
"2007-12-19"
"2007-12-19T10:20+0300
"2007-12-19T10:20:30+0300
"2007-12-19T10:20:30.567+0300
Additionally a timezone offset of "+0000" can be substituted as "Z".
Parsing is done in a fuzzy way. If there is an illegal character somewhere in the String, the date parsed so far will be returned, e.g. the input "2007-12-19FOO" would return a date that represents "2007-12-19".

Specified by:

parse in interface DateFormatter

Specified by:

parse in class AbstractFormatter

Parameters:

s -

Returns:

Throws:

java.text.ParseException

format

public final java.lang.String format(java.util.Date date)

Creates a String representation of a Date using the format defined in ISO8601/W3C datetime The result will be in UTC/GMT, e.g. "2007-12-19T10:20:30Z".

Specified by:

format in interface DateFormatter

Specified by:

format in class AbstractFormatter

Parameters:

date - The Date instance to transform.

Returns:

A fixed width (20 chars) ISO8601 date String.

format

public final java.lang.String format()

Specified by:

format in interface DateFormatter

Specified by:

format in class AbstractFormatter