com.atlassian.jira.rest
Class Dates

java.lang.Object
  com.atlassian.jira.rest.Dates

public class Dates
extends Object

Utility class for formatting and parsing date and date/time objects in ISO8601 format.

Since:

v4.2

Nested Class Summary

static class	Dates.DateAdapter
static class	Dates.DateTimeAdapter

Field Summary

static String	DATE_FORMAT The format used for dates in the REST plugin.
static org.joda.time.format.DateTimeFormatter	ISO_DATE_TIME_PARSER Parser for rest times - this one - accepts Z as timezone.
static org.joda.time.format.DateTimeFormatter	ISO_DATE_TIME_PRINTER Printer for rest time entries - this one should print +0000 for UTC timezone.
static String	TIME_FORMAT The format used for times in the REST plugin.

Method Summary

static String	asDateString(Date date) Converts the given Date object to a String.
static String	asDateString(Timestamp timestamp) Converts the given Timestamp object to a String.
static String	asISODateTimeString(org.joda.time.DateTime dateTime) Converts the given DateTime object to ISO String.
static String	asTimeString(Date date) Converts the given Date object to a String.
static String	asTimeString(Timestamp timestamp) Converts the given Timestamp object to a String.
static Date	fromDateString(String date) Converts the given date String into a Date object.
static org.joda.time.DateTime	fromISODateTimeString(String date)
static Date	fromTimeString(String time) Converts the given date and time String to a Date object.

Methods inherited from class java.lang.Object

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

Field Detail

DATE_FORMAT

public static final String DATE_FORMAT

The format used for dates in the REST plugin.

See Also:

Constant Field Values

TIME_FORMAT

public static final String TIME_FORMAT

The format used for times in the REST plugin.

See Also:

Constant Field Values

ISO_DATE_TIME_PARSER

public static final org.joda.time.format.DateTimeFormatter ISO_DATE_TIME_PARSER

Parser for rest times - this one - accepts Z as timezone.

ISO_DATE_TIME_PRINTER

public static final org.joda.time.format.DateTimeFormatter ISO_DATE_TIME_PRINTER

Printer for rest time entries - this one should print +0000 for UTC timezone.

Method Detail

asTimeString

public static String asTimeString(@Nullable
                                  Date date)

Converts the given Date object to a String. The returned string is in the format "yyyy-MM-dd\'T\'HH:mm:ss.SSSZ".

Parameters:

date - a Date

Returns:

a String representation of the date and time

asTimeString

public static String asTimeString(@Nullable
                                  Timestamp timestamp)

Converts the given Timestamp object to a String. The returned string is in the format "yyyy-MM-dd\'T\'HH:mm:ss.SSSZ".

Parameters:

timestamp - a Date

Returns:

a String representation of the timestamp and time

fromTimeString

public static Date fromTimeString(@Nullable
                                  String time)
                           throws IllegalArgumentException

Converts the given date and time String to a Date object. The time parameter is expected to be in the format "yyyy-MM-dd\'T\'HH:mm:ss.SSSZ".

Parameters:

time - a String representation of a date and time

Returns:

a Date

Throws:

RuntimeException - if there is an error parsing the date

IllegalArgumentException - if the input string is not in the expected format

asDateString

public static String asDateString(@Nullable
                                  Date date)

Converts the given Date object to a String. The returned string is in the format "yyyy-MM-dd".

Parameters:

date - a Date

Returns:

a String representation of the date

asDateString

public static String asDateString(@Nullable
                                  Timestamp timestamp)

Converts the given Timestamp object to a String. The returned string is in the format "yyyy-MM-dd".

Parameters:

timestamp - a Date

Returns:

a String representation of the timestamp

fromDateString

public static Date fromDateString(@Nullable
                                  String date)
                           throws IllegalArgumentException

Converts the given date String into a Date object. The date parameter is expected to be in the format "yyyy-MM-dd".

Parameters:

date - a String containing a date

Returns:

a Date

Throws:

IllegalArgumentException - if the input string is not in the expected format

asISODateTimeString

public static String asISODateTimeString(@Nullable
                                         org.joda.time.DateTime dateTime)

Converts the given DateTime object to ISO String.

fromISODateTimeString

public static org.joda.time.DateTime fromISODateTimeString(@Nullable
                                                           String date)