net.sf.mmm.util.date.base

Class Iso8601UtilImpl

java.lang.Object

net.sf.mmm.util.date.base.Iso8601UtilLimitedImpl

net.sf.mmm.util.date.base.Iso8601UtilImpl

All Implemented Interfaces:

Iso8601Util, Iso8601UtilLimited

@Singleton
 @Named(value="net.sf.mmm.util.date.api.Iso8601Util")
public final class Iso8601UtilImpl
extends Iso8601UtilLimitedImpl
implements Iso8601Util

This is the implementation of the Iso8601Util interface. It does NOT use SimpleDateFormat. All methods of this class are fast and thread-safe.

Since:

1.0.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

See Also:

getInstance()

Field Summary

Fields

Modifier and Type	Field and Description
private static Iso8601UtilImpl	instance
private static TimeZone	TZ_UTC The UTC TimeZone.
private static String	UTC_ID The ID for UTC (Coordinated Universal Time).

Fields inherited from class net.sf.mmm.util.date.base.Iso8601UtilLimitedImpl

MAX_DAY_OF_MONTH, MAX_MONTH

Fields inherited from interface net.sf.mmm.util.date.api.Iso8601Util

CDI_NAME, PATTERN_ALL

Fields inherited from interface net.sf.mmm.util.date.api.Iso8601UtilLimited

PATTERN_STRING_ALL, PATTERN_STRING_DATE, PATTERN_STRING_TIME, PATTERN_STRING_TIMEZONE

Constructor Summary

Constructors

Constructor and Description
Iso8601UtilImpl() The constructor.

Method Summary

Modifier and Type	Method and Description
String	formatDate(Calendar calendar) This method formats the given calendar as a date in the format "yyyy-MM-dd" according to ISO 8601.
String	formatDate(Calendar calendar, boolean extended) This method formats the given calendar as a date in the format "yyyy-MM-dd" according to ISO 8601.
void	formatDate(Calendar calendar, boolean extended, Appendable buffer) This method formats the given calendar as a date according to ISO 8601.
void	formatDate(Date date, boolean extended, Appendable buffer) This method formats the given date as a date according to ISO 8601.
String	formatDateTime(Calendar calendar) This method formats the given calendar as a date and time in the format "yyyy-MM-ddTHH:mm:ss±hh:mm" according to ISO 8601.
String	formatDateTime(Calendar calendar, boolean extendedDate, boolean extendedTime, boolean extendedTimezone) This method formats the given calendar as a date and time according to ISO 8601.
void	formatDateTime(Calendar calendar, boolean extendedDate, boolean extendedTime, boolean extendedTimezone, Appendable buffer) This method formats the given calendar as a date and time according to ISO 8601.
void	formatDateTime(Date date, boolean extendedDate, boolean extendedTime, boolean extendedTimeZone, Appendable buffer) This method formats the given date as a date and time according to ISO 8601.
void	formatTime(Calendar calendar, boolean extended, Appendable buffer) This method formats the given calendar as time according to ISO 8601.
void	formatTimeZone(Calendar calendar, boolean extended, Appendable buffer) This method formats the given timezone according to ISO 8601.
static Iso8601UtilImpl	getInstance() This method gets the singleton instance of this Iso8601UtilImpl.
Calendar	parseCalendar(String date) This method parses the given string date according to ISO 8601.
void	parseCalendar(String date, Calendar calendar) This method parses the given date according to ISO 8601 using the given calendar.
Date	parseDate(String date) This method parses the given string date according to ISO 8601.
private TimeZone	parseTimezone(CharSequenceScanner scanner) This method parses the timezone from the given parser.

Methods inherited from class net.sf.mmm.util.date.base.Iso8601UtilLimitedImpl

formatDate, formatDate, formatDate, formatDateTime, formatDateTime, formatTime, formatTime, formatTimeZone, parseDate, parseTime, parseTimezoneOffset

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.sf.mmm.util.date.api.Iso8601UtilLimited

formatDate, formatDate, formatDateTime, formatDateTime, formatTime, formatTimeZone

Field Detail

instance

private static Iso8601UtilImpl instance

See Also:

getInstance()

UTC_ID

private static final String UTC_ID

The ID for UTC (Coordinated Universal Time).

See Also:

Constant Field Values

TZ_UTC

private static final TimeZone TZ_UTC

The UTC TimeZone.

Constructor Detail

Iso8601UtilImpl

public Iso8601UtilImpl()

The constructor.

Method Detail

getInstance

public static Iso8601UtilImpl getInstance()

This method gets the singleton instance of this Iso8601UtilImpl.
ATTENTION:
Please read Cdi.GET_INSTANCE before using.

Returns:

the singleton instance.

formatDate

public void formatDate(Date date,
                       boolean extended,
                       Appendable buffer)

This method formats the given date as a date according to ISO 8601.

Specified by:

formatDate in interface Iso8601UtilLimited

Overrides:

formatDate in class Iso8601UtilLimitedImpl

Parameters:

date - is the Date to format.

extended - if false the basic date format ("yyyyMMdd") is used, if true the extended date format ("yyyy-MM-dd") is used.

buffer - is where to append the formatted date.

formatDate

public String formatDate(Calendar calendar)

This method formats the given calendar as a date in the format "yyyy-MM-dd" according to ISO 8601.

Specified by:

formatDate in interface Iso8601Util

Parameters:

calendar - is the date to format.

Returns:

the given calendar as date string.

formatDate

public String formatDate(Calendar calendar,
                         boolean extended)

This method formats the given calendar as a date in the format "yyyy-MM-dd" according to ISO 8601.

Specified by:

formatDate in interface Iso8601Util

Parameters:

calendar - is the date to format.

extended - if false the basic format ("yyyyMMdd") is used, if true the extended format ("yyyy-MM-dd") is used.

Returns:

the given calendar as date string.

formatDate

public void formatDate(Calendar calendar,
                       boolean extended,
                       Appendable buffer)

This method formats the given calendar as a date according to ISO 8601.

Specified by:

formatDate in interface Iso8601Util

Parameters:

calendar - is the date to format.

extended - if false the basic date format ("yyyyMMdd") is used, if true the extended date format ("yyyy-MM-dd") is used.

buffer - is where to append the formatted date.

formatDateTime

public void formatDateTime(Date date,
                           boolean extendedDate,
                           boolean extendedTime,
                           boolean extendedTimeZone,
                           Appendable buffer)

This method formats the given date as a date and time according to ISO 8601.

Specified by:

formatDateTime in interface Iso8601UtilLimited

Overrides:

formatDateTime in class Iso8601UtilLimitedImpl

Parameters:

date - is the Date to format.

extendedDate - if false the basic date format ("yyyyMMdd") is used, if true the extended date format ("yyyy-MM-dd") is used.

extendedTime - if false the basic time format ("HHmmss") is used, if true the extended time format ("HH:mm:ss") is used.

extendedTimeZone - if false the basic timezone format ("±HHmm[ss]") is used, if true the extended timezone format ("±HH:mm[:ss]") is used.

buffer - is where to append the formatted date and time.

formatDateTime

public String formatDateTime(Calendar calendar)

This method formats the given calendar as a date and time in the format "yyyy-MM-ddTHH:mm:ss±hh:mm" according to ISO 8601.

Specified by:

formatDateTime in interface Iso8601Util

Parameters:

calendar - is the date to format.

Returns:

the given calendar as date string.

formatDateTime

public String formatDateTime(Calendar calendar,
                             boolean extendedDate,
                             boolean extendedTime,
                             boolean extendedTimezone)

This method formats the given calendar as a date and time according to ISO 8601.

Specified by:

formatDateTime in interface Iso8601Util

Parameters:

calendar - is the Calendar to format.

extendedDate - if false the basic date format ("yyyyMMdd") is used, if true the extended date format ("yyyy-MM-dd") is used.

extendedTime - if false the basic time format ("HHmmss") is used, if true the extended time format ("HH:mm:ss") is used.

extendedTimezone - if false the basic timezone format ("±HHmm[ss]") is used, if true the extended timezone format ("±HH:mm[:ss]") is used.

Returns:

the given calendar as date string.

formatDateTime

public void formatDateTime(Calendar calendar,
                           boolean extendedDate,
                           boolean extendedTime,
                           boolean extendedTimezone,
                           Appendable buffer)

This method formats the given calendar as a date and time according to ISO 8601.

Specified by:

formatDateTime in interface Iso8601Util

Parameters:

calendar - is the Calendar to format.

extendedDate - if false the basic date format ("yyyyMMdd") is used, if true the extended date format ("yyyy-MM-dd") is used.

extendedTime - if false the basic time format ("HHmmss") is used, if true the extended time format ("HH:mm:ss") is used.

extendedTimezone - if false the basic timezone format ("±HHmm[ss]") is used, if true the extended timezone format ("±HH:mm[:ss]") is used.

buffer - is where to append the formatted date and time.

formatTime

public void formatTime(Calendar calendar,
                       boolean extended,
                       Appendable buffer)

This method formats the given calendar as time according to ISO 8601.

Specified by:

formatTime in interface Iso8601Util

Parameters:

calendar - is the Calendar to format.

extended - if false the basic time format ("HHmmss") is used, if true the extended time format ("HH:mm:ss") is used.

buffer - is where to append the formatted date.

formatTimeZone

public void formatTimeZone(Calendar calendar,
                           boolean extended,
                           Appendable buffer)

This method formats the given timezone according to ISO 8601.

Specified by:

formatTimeZone in interface Iso8601Util

Parameters:

calendar - is the Calendar to format.

extended - - if false the basic timezone format ("±HHmm[ss]") is used, if true the extended timezone format ("±HH:mm[:ss]") is used.

buffer - is where to append the formatted timezone.

parseDate

public Date parseDate(String date)

This method parses the given string date according to ISO 8601.

Specified by:

parseDate in interface Iso8601UtilLimited

Overrides:

parseDate in class Iso8601UtilLimitedImpl

Parameters:

date - is the date to parse.

Returns:

the parsed date.

parseCalendar

public Calendar parseCalendar(String date)

This method parses the given string date according to ISO 8601.

Specified by:

parseCalendar in interface Iso8601Util

Parameters:

date - is the date to parse.

Returns:

the parsed date.

parseTimezone

private TimeZone parseTimezone(CharSequenceScanner scanner)

This method parses the timezone from the given parser.

Parameters:

scanner - is the parser pointing to the timezone or at the end of the string

Returns:

the parsed timezone or null if parser already at the end of the string.

parseCalendar

public void parseCalendar(String date,
                          Calendar calendar)

This method parses the given date according to ISO 8601 using the given calendar. If the given date does NOT specify the time or timezone, the values from the given calendar will be kept.

Specified by:

parseCalendar in interface Iso8601Util

Parameters:

date - is the date to parse.

calendar - is the calendar where the parsed date will be set.