io.jsonwebtoken.lang

Class DateFormats

java.lang.Object

io.jsonwebtoken.lang.DateFormats

public final class DateFormats
extends Object

Utility methods to format and parse date strings.

Since:

0.10.0

Method Summary

Methods

Modifier and Type	Method and Description
static String	formatIso8601(Date date) Return an ISO-8601-formatted string with millisecond precision representing the specified date.
static String	formatIso8601(Date date, boolean includeMillis) Returns an ISO-8601-formatted string with optional millisecond precision for the specified date.
static Date	parseIso8601Date(String s) Parse the specified ISO-8601-formatted date string and return the corresponding Date instance.

Methods inherited from class java.lang.Object

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

Method Detail

formatIso8601

public static String formatIso8601(Date date)

Return an ISO-8601-formatted string with millisecond precision representing the specified date.

Parameters:

date - the date for which to create an ISO-8601-formatted string

Returns:

the date represented as an ISO-8601-formatted string with millisecond precision.

formatIso8601

public static String formatIso8601(Date date,
                   boolean includeMillis)

Returns an ISO-8601-formatted string with optional millisecond precision for the specified date.

Parameters:

date - the date for which to create an ISO-8601-formatted string

includeMillis - whether to include millisecond notation within the string.

Returns:

the date represented as an ISO-8601-formatted string with optional millisecond precision.

parseIso8601Date

public static Date parseIso8601Date(String s)
                             throws ParseException

Parse the specified ISO-8601-formatted date string and return the corresponding Date instance. The date string may optionally contain millisecond notation, and those milliseconds will be represented accordingly.

Parameters:

s - the ISO-8601-formatted string to parse

Returns:

the string's corresponding Date instance.

Throws:

ParseException - if the specified date string is not a validly-formatted ISO-8601 string.