ISO8601 (eXo PLF:: Kernel :: Commons Utils 6.0.0 API)

java.lang.Object
- org.exoplatform.commons.utils.ISO8601

```
public class ISO8601
extends Object
```
Created by The eXo Platform SAS Author : Peter Nedonosko peter.nedonosko@exoplatform.com.ua 05.07.2007 ISO 8601 standard Year: YYYY (eg 1997) Year and month: YYYY-MM (eg 1997-07) Complete date: YYYY-MM-DD (eg 1997-07-16) Complete date plus hours and minutes: YYYY-MM-DDThh:mmTZD (eg 1997-07-16T19:20+01:00) Complete date plus hours, minutes and seconds: YYYY-MM-DDThh:mm:ssTZD (eg 1997-07-16T19:20:30+01:00) Complete date plus hours, minutes, seconds and a decimal fraction of a second YYYY-MM-DDThh:mm:ss.sTZD (eg 1997-07-16T19:20:30.45+01:00) where: YYYY = four-digit year MM = two-digit month (01=January, etc.) DD = two-digit day of month (01 through 31) hh = two digits of hour (00 through 23) (am/pm NOT allowed) mm = two digits of minute (00 through 59) ss = two digits of second (00 through 59) s = one or more digits representing a decimal fraction of a second TZD = time zone designator (Z or +hh:mm or -hh:mm) a RFC 822 time zone is also accepted: For formatting, the RFC 822 4-digit time zone format is used: RFC822TimeZone: Sign TwoDigitHours Minutes TwoDigitHours: Digit Digit like -8000

Version:

$Id: ISO8601.java 34394 2009-07-23 09:23:31Z dkatayev $

Author:

Peter Nedonosko

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

protected static class ISO8601.ISODateFormat

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`ISO8601.ISODateFormat`

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`COMPLETE_DATE_FORMAT` Complete date: YYYY-MM-DD (eg 1997-07-16)
`static String`	`COMPLETE_DATEHOURSMINUTESZ_FORMAT` Complete date plus hours and minutes: YYYY-MM-DDThh:mmTZD (eg 1997-07-16T19:20+01:00)
`static String`	`COMPLETE_DATEHOURSMINUTESZRFC822_FORMAT` NON ISO STANDARD.
`static String`	`COMPLETE_DATETIMEMSZ_FORMAT` Complete date plus hours, minutes, seconds and a decimal fraction of a second YYYY-MM-DDThh:mm:ss.sTZD (eg 1997-07-16T19:20:30.450+01:00)
`static String`	`COMPLETE_DATETIMEMSZ_FORMAT_1` Complete date plus hours, minutes, seconds and a decimal fraction of a second YYYY-MM-DDThh:mm:ss.sTZD (eg 1997-07-16T19:20:30.45+01:00)
`static String`	`COMPLETE_DATETIMEMSZRFC822_FORMAT` Complete date plus hours, minutes, seconds and a decimal fraction of a second, with time zone by RFC822 YYYY-MM-DDThh:mm:ss.sZ (eg 1997-07-16T19:20:30.450+0100)
`static String`	`COMPLETE_DATETIMEMSZRFC822_FORMAT_1` Complete date plus hours, minutes, seconds and a decimal fraction of a second, with time zone by RFC822 YYYY-MM-DDThh:mm:ss.sZ (eg 1997-07-16T19:20:30.45+0100)
`static String`	`COMPLETE_DATETIMEZ_FORMAT` Complete date plus hours, minutes and seconds: YYYY-MM-DDThh:mm:ssTZD (eg 1997-07-16T19:20:30+01:00)
`static String`	`COMPLETE_DATETIMEZRFC822_FORMAT` NON ISO STANDARD.
`static String[]`	`FORMATS` Possible formats list.
`static String[]`	`LEGACY_FORMATS`
`static String`	`SIMPLE_DATEHOURSMINUTES_FORMAT` NON ISO STANDARD.
`static String`	`SIMPLE_DATETIME_FORMAT` NON ISO STANDARD.
`static String`	`SIMPLE_DATETIMEMS_FORMAT` NON ISO STANDARD.
`static String`	`SIMPLE_DATETIMEMS_FORMAT_1` NON ISO STANDARD.
`protected static String`	`TZD` ISO 8601 time zone designator
`static String`	`YEAR_FORMAT` Year: YYYY (eg 1997)
`static String`	`YEARMONTH_FORMAT` Year and month: YYYY-MM (eg 1997-07)

Constructor Summary

Constructors
Constructor and Description

ISO8601()

Constructors
Constructor and Description
`ISO8601()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`format(Calendar date)` Format date using format: complete date plus hours, minutes, seconds and a decimal fraction of a second.
`static Calendar`	`parse(String dateString)` Parse string using possible formats list.
`static Calendar`	`parse(String dateString, String[] formats)` Parse string using given formats list.
`static Calendar`	`parseEx(String dateString)` Parse string using possible formats list.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - TZD
```
protected static final String TZD
```
    ISO 8601 time zone designator
    
    See Also:
    
    Constant Field Values
  - YEAR_FORMAT
```
public static final String YEAR_FORMAT
```
    Year: YYYY (eg 1997)
    
    See Also:
    
    Constant Field Values
  - YEARMONTH_FORMAT
```
public static final String YEARMONTH_FORMAT
```
    Year and month: YYYY-MM (eg 1997-07)
    
    See Also:
    
    Constant Field Values
  - COMPLETE_DATE_FORMAT
```
public static final String COMPLETE_DATE_FORMAT
```
    Complete date: YYYY-MM-DD (eg 1997-07-16)
    
    See Also:
    
    Constant Field Values
  - SIMPLE_DATEHOURSMINUTES_FORMAT
```
public static final String SIMPLE_DATEHOURSMINUTES_FORMAT
```
    NON ISO STANDARD. Simple date plus hours and minutes, without time zone: YYYY-MM-DDThh:mm (eg 1997-07-16T19:20)
    
    See Also:
    
    Constant Field Values
  - COMPLETE_DATEHOURSMINUTESZRFC822_FORMAT
```
public static final String COMPLETE_DATEHOURSMINUTESZRFC822_FORMAT
```
    NON ISO STANDARD. Complete date plus hours and minutes, with time zone by RFC822: YYYY-MM-DDThh:mmZ (eg 1997-07-16T19:20+0100)
    
    See Also:
    
    Constant Field Values
  - COMPLETE_DATEHOURSMINUTESZ_FORMAT
```
public static final String COMPLETE_DATEHOURSMINUTESZ_FORMAT
```
    Complete date plus hours and minutes: YYYY-MM-DDThh:mmTZD (eg 1997-07-16T19:20+01:00)
    
    See Also:
    
    Constant Field Values
  - SIMPLE_DATETIME_FORMAT
```
public static final String SIMPLE_DATETIME_FORMAT
```
    NON ISO STANDARD. Simple date plus hours, minutes and seconds, without time zone: YYYY-MM-DDThh:mm:ss (eg 1997-07-16T19:20:30)
    
    See Also:
    
    Constant Field Values
  - COMPLETE_DATETIMEZRFC822_FORMAT
```
public static final String COMPLETE_DATETIMEZRFC822_FORMAT
```
    NON ISO STANDARD. Complete date plus hours, minutes and seconds, with time zone by RFC822: YYYY-MM-DDThh:mm:ssZ (eg 1997-07-16T19:20:30+0100)
    
    See Also:
    
    Constant Field Values
  - COMPLETE_DATETIMEZ_FORMAT
```
public static final String COMPLETE_DATETIMEZ_FORMAT
```
    Complete date plus hours, minutes and seconds: YYYY-MM-DDThh:mm:ssTZD (eg 1997-07-16T19:20:30+01:00)
    
    See Also:
    
    Constant Field Values
  - SIMPLE_DATETIMEMS_FORMAT_1
```
public static final String SIMPLE_DATETIMEMS_FORMAT_1
```
    NON ISO STANDARD. Simple date plus hours, minutes, seconds and a decimal fraction of a second, without time zone YYYY-MM-DDThh:mm:ss.s (eg 1997-07-16T19:20:30.45)
    
    See Also:
    
    Constant Field Values
  - SIMPLE_DATETIMEMS_FORMAT
```
public static final String SIMPLE_DATETIMEMS_FORMAT
```
    NON ISO STANDARD. Simple date plus hours, minutes, seconds and a decimal fraction of a second, without time zone YYYY-MM-DDThh:mm:ss.s (eg 1997-07-16T19:20:30.450)
    
    See Also:
    
    Constant Field Values
  - COMPLETE_DATETIMEMSZRFC822_FORMAT_1
```
public static final String COMPLETE_DATETIMEMSZRFC822_FORMAT_1
```
    Complete date plus hours, minutes, seconds and a decimal fraction of a second, with time zone by RFC822 YYYY-MM-DDThh:mm:ss.sZ (eg 1997-07-16T19:20:30.45+0100)
    
    See Also:
    
    Constant Field Values
  - COMPLETE_DATETIMEMSZRFC822_FORMAT
```
public static final String COMPLETE_DATETIMEMSZRFC822_FORMAT
```
    Complete date plus hours, minutes, seconds and a decimal fraction of a second, with time zone by RFC822 YYYY-MM-DDThh:mm:ss.sZ (eg 1997-07-16T19:20:30.450+0100)
    
    See Also:
    
    Constant Field Values
  - COMPLETE_DATETIMEMSZ_FORMAT
```
public static final String COMPLETE_DATETIMEMSZ_FORMAT
```
    Complete date plus hours, minutes, seconds and a decimal fraction of a second YYYY-MM-DDThh:mm:ss.sTZD (eg 1997-07-16T19:20:30.450+01:00)
    
    See Also:
    
    Constant Field Values
  - COMPLETE_DATETIMEMSZ_FORMAT_1
```
public static final String COMPLETE_DATETIMEMSZ_FORMAT_1
```
    Complete date plus hours, minutes, seconds and a decimal fraction of a second YYYY-MM-DDThh:mm:ss.sTZD (eg 1997-07-16T19:20:30.45+01:00)
    
    See Also:
    
    Constant Field Values
  - FORMATS
```
public static final String[] FORMATS
```
    Possible formats list. ISO 8601, RFC822 + simple formats in order of priority of parse
  - LEGACY_FORMATS
```
public static final String[] LEGACY_FORMATS
```
- Constructor Detail
  - ISO8601
```
public ISO8601()
```
- Method Detail
  - format
```
public static String format(Calendar date)
```
    Format date using format: complete date plus hours, minutes, seconds and a decimal fraction of a second.
    
    Parameters:
    
    date -
    
    Returns:
  - parse
```
public static Calendar parse(String dateString)
```
    Parse string using possible formats list.
    
    Parameters:
    
    dateString - - date string
    
    Returns:
    
    - calendar or null if dateString is inparseable text
  - parseEx
```
public static Calendar parseEx(String dateString)
                        throws ParseException,
                               NumberFormatException
```
    Parse string using possible formats list.
    
    Parameters:
    
    dateString - - date string
    
    Returns:
    
    - calendar
    
    Throws:
    
    ParseException
    
    NumberFormatException
  - parse
```
public static Calendar parse(String dateString,
                             String[] formats)
                      throws ParseException,
                             NumberFormatException
```
    Parse string using given formats list.
    
    Parameters:
    
    dateString -
    
    formats -
    
    Returns:
    
    Throws:
    
    ParseException
    
    NumberFormatException

Class ISO8601

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

TZD

YEAR_FORMAT

YEARMONTH_FORMAT

COMPLETE_DATE_FORMAT

SIMPLE_DATEHOURSMINUTES_FORMAT

COMPLETE_DATEHOURSMINUTESZRFC822_FORMAT

COMPLETE_DATEHOURSMINUTESZ_FORMAT

SIMPLE_DATETIME_FORMAT

COMPLETE_DATETIMEZRFC822_FORMAT

COMPLETE_DATETIMEZ_FORMAT

SIMPLE_DATETIMEMS_FORMAT_1

SIMPLE_DATETIMEMS_FORMAT

COMPLETE_DATETIMEMSZRFC822_FORMAT_1

COMPLETE_DATETIMEMSZRFC822_FORMAT

COMPLETE_DATETIMEMSZ_FORMAT

COMPLETE_DATETIMEMSZ_FORMAT_1

FORMATS

LEGACY_FORMATS

Constructor Detail

ISO8601

Method Detail

format

parse

parseEx

parse