com.landawn.abacus.util

Class ISO8601Util

java.lang.Object

com.landawn.abacus.util.ISO8601Util

public final class ISO8601Util
extends Object

Copyright (c) 2017, Jackson Authors/Contributers. Utilities methods for manipulating dates in iso8601 format. This is much much faster and GC friendly than using SimpleDateFormat so highly suitable if you (un)serialize lots of date objects. Supported parse format: [yyyy-MM-dd|yyyyMMdd][T(hh:mm[:ss[.sss]]|hhmm[ss[.sss]])]?[Z|[+-]hh[:]mm]]

See Also:

this specification

Method Summary

Modifier and Type	Method and Description
static String	format(Date date) Format a date into 'yyyy-MM-ddThh:mm:ssZ' (default timezone, no milliseconds precision).
static String	format(Date date, boolean millis) Format a date into 'yyyy-MM-ddThh:mm:ss[.sss]Z' (GMT timezone)
static String	format(Date date, boolean millis, TimeZone tz) Deprecated.
static String	format(Date date, boolean millis, TimeZone tz, Locale loc) Format date into yyyy-MM-ddThh:mm:ss[.sss][Z|[+-]hh:mm]
static Date	parse(String date)
static Date	parse(String date, ParsePosition pos) Parse a date from ISO-8601 formatted string.

Methods inherited from class java.lang.Object

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

Method Detail

format

public static String format(Date date)

Format a date into 'yyyy-MM-ddThh:mm:ssZ' (default timezone, no milliseconds precision).

Parameters:

date - the date to format

Returns:

format

public static String format(Date date,
                            boolean millis)

Format a date into 'yyyy-MM-ddThh:mm:ss[.sss]Z' (GMT timezone)

Parameters:

date - the date to format

millis - true to include millis precision otherwise false

Returns:

format

@Deprecated
public static String format(Date date,
                                         boolean millis,
                                         TimeZone tz)

Deprecated.

Parameters:

date -

millis -

tz -

Returns:

format

public static String format(Date date,
                            boolean millis,
                            TimeZone tz,
                            Locale loc)

Format date into yyyy-MM-ddThh:mm:ss[.sss][Z|[+-]hh:mm]

Parameters:

date - the date to format

millis - true to include millis precision otherwise false

tz - timezone to use for the formatting (UTC will produce 'Z')

loc -

Returns:

Since:

2.9

parse

public static Date parse(String date)

Parameters:

date -

Returns:

parse

public static Date parse(String date,
                         ParsePosition pos)

Parse a date from ISO-8601 formatted string. It expects a format [yyyy-MM-dd|yyyyMMdd][T(hh:mm[:ss[.sss]]|hhmm[ss[.sss]])]?[Z|[+-]hh:mm]]

Parameters:

date - ISO string to parse in the appropriate format.

pos - The position to start parsing from, updated to where parsing stopped.

Returns: