com.google.gson.internal.bind.util

类 ISO8601Utils

java.lang.Object

com.google.gson.internal.bind.util.ISO8601Utils

public class ISO8601Utils
extends Object

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]]

另请参阅:

this specification

构造器概要

构造器

构造器和说明
ISO8601Utils()

方法概要

限定符和类型	方法和说明
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) Format date into yyyy-MM-ddThh:mm:ss[.sss][Z|[+-]hh:mm]
static Date	parse(String date, ParsePosition pos) Parse a date from ISO-8601 formatted string.

从类继承的方法 java.lang.Object

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

构造器详细资料

ISO8601Utils

public ISO8601Utils()

方法详细资料

format

public static String format(Date date)

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

参数:

date - the date to format

返回:

the date formatted as 'yyyy-MM-ddThh:mm:ssZ'

format

public static String format(Date date,
                            boolean millis)

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

参数:

date - the date to format

millis - true to include millis precision otherwise false

返回:

the date formatted as 'yyyy-MM-ddThh:mm:ss[.sss]Z'

format

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

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

参数:

date - the date to format

millis - true to include millis precision otherwise false

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

返回:

the date formatted as yyyy-MM-ddThh:mm:ss[.sss][Z|[+-]hh:mm]

parse

public static Date parse(String date,
                         ParsePosition pos)
                  throws ParseException

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]]]

参数:

date - ISO string to parse in the appropriate format.

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

返回:

the parsed date

抛出:

ParseException - if the date is not in the appropriate format