Package org.gitlab4j.api.utils

Class ISO8601

java.lang.Object

org.gitlab4j.api.utils.ISO8601

public class ISO8601
extends Object

This class provides utility methods for parsing and formatting ISO8601 formatted dates.

Field Summary

Fields

Modifier and Type	Field	Description
static String	DATE_ONLY_PATTERN
static String	MSEC_PATTERN
static String	OUTPUT_MSEC_PATTERN
static String	OUTPUT_PATTERN
static String	PATTERN
static String	PATTERN_MSEC
static String	SPACEY_MSEC_PATTERN
static String	SPACEY_PATTERN
static String	UTC_PATTERN

Constructor Summary

Constructors

Constructor	Description
ISO8601()

Method Summary

Modifier and Type	Method	Description
static String	dateOnly(Date date)	Get a string that includes the date only in yyyy-mm-ss format.
static String	getTimestamp()	Get a ISO8601 formatted string for the current date and time.
static String	getTimestamp(boolean withMsec)	Get a ISO8601formatted string for the current date and time.
static Calendar	toCalendar(String dateTimeString)	Parses an ISO8601 formatted string a returns a Calendar instance.
static Date	toDate(String dateTimeString)	Parses an ISO8601 formatted string a returns a Date instance.
static Instant	toInstant(String dateTimeString)	Parses an ISO8601 formatted string a returns an Instant instance.
static String	toString(Calendar cal)	Get a ISO8601 formatted string for the provided Calendar instance.
static String	toString(Date date)	Get a ISO8601 formatted string for the provided Date instance.
static String	toString(Date date, boolean withMsec)	Get a ISO8601 formatted string for the provided Date instance.

Methods inherited from class java.lang.Object

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

Field Details

PATTERN

public static final String PATTERN

See Also:

Constant Field Values

MSEC_PATTERN

public static final String MSEC_PATTERN

See Also:

Constant Field Values

SPACEY_PATTERN

public static final String SPACEY_PATTERN

See Also:

Constant Field Values

SPACEY_MSEC_PATTERN

public static final String SPACEY_MSEC_PATTERN

See Also:

Constant Field Values

PATTERN_MSEC

public static final String PATTERN_MSEC

See Also:

Constant Field Values

OUTPUT_PATTERN

public static final String OUTPUT_PATTERN

See Also:

Constant Field Values

OUTPUT_MSEC_PATTERN

public static final String OUTPUT_MSEC_PATTERN

See Also:

Constant Field Values

UTC_PATTERN

public static final String UTC_PATTERN

See Also:

Constant Field Values

DATE_ONLY_PATTERN

public static final String DATE_ONLY_PATTERN

See Also:

Constant Field Values

Constructor Details

ISO8601

public ISO8601()

Method Details

getTimestamp

public static String getTimestamp()

Get a ISO8601 formatted string for the current date and time.

Returns:

a ISO8601 formatted string for the current date and time

getTimestamp

public static String getTimestamp(boolean withMsec)

Get a ISO8601formatted string for the current date and time.

Parameters:

withMsec - flag indicating whether to include milliseconds

Returns:

a ISO8601 formatted string for the current date and time

toString

public static String toString(Calendar cal)

Get a ISO8601 formatted string for the provided Calendar instance.

Parameters:

cal - the Calendar instance to get the ISO8601 formatted string for

Returns:

a ISO8601 formatted string for the provided Calendar instance, or null if call is null

toString

public static String toString(Date date,
boolean withMsec)

Get a ISO8601 formatted string for the provided Date instance.

Parameters:

date - the Date instance to get the ISO8601 formatted string for

withMsec - flag indicating whether to include milliseconds

Returns:

a ISO8601 formatted string for the provided Date instance, or null if date is null

dateOnly

public static String dateOnly(Date date)

Get a string that includes the date only in yyyy-mm-ss format.

Parameters:

date - the Date instance to get the date only formatted string for

Returns:

a string that includes the date only in yyyy-mm-ss format, or null if date is null

toString

public static String toString(Date date)

Get a ISO8601 formatted string for the provided Date instance.

Parameters:

date - the Date instance to get the ISO8601 formatted string for

Returns:

a ISO8601 formatted string for the provided Date instance, or null if date is null

toInstant

public static Instant toInstant(String dateTimeString)
                         throws ParseException

Parses an ISO8601 formatted string a returns an Instant instance.

Parameters:

dateTimeString - the ISO8601 formatted string

Returns:

an Instant instance for the ISO8601 formatted string

Throws:

ParseException - if the provided string is not in the proper format

toDate

public static Date toDate(String dateTimeString)
                   throws ParseException

Parses an ISO8601 formatted string a returns a Date instance.

Parameters:

dateTimeString - the ISO8601 formatted string

Returns:

a Date instance for the ISO8601 formatted string

Throws:

ParseException - if the provided string is not in the proper format

toCalendar

public static Calendar toCalendar(String dateTimeString)
                           throws ParseException

Parses an ISO8601 formatted string a returns a Calendar instance.

Parameters:

dateTimeString - the ISO8601 formatted string

Returns:

a Calendar instance for the ISO8601 formatted string

Throws:

ParseException - if the provided string is not in the proper format