Package ca.uhn.fhir.util

Class DateUtils

java.lang.Object

ca.uhn.fhir.util.DateUtils

public final class DateUtils
extends Object

A utility class for parsing and formatting HTTP dates as used in cookies and other headers. This class handles dates as defined by RFC 2616 section 3.3.1 as well as some other common non-standard formats.

This class is basically intended to be a high-performance workaround for the fact that Java SimpleDateFormat is kind of expensive to create and yet isn't thread safe.

This class was adapted from the class with the same name from the Jetty project, licensed under the terms of the Apache Software License 2.0.

Field Summary

Fields

Modifier and Type	Field	Description
static final TimeZone	GMT	GMT TimeZone
static final String	PATTERN_ASCTIME	Date format pattern used to parse HTTP date headers in ANSI C asctime() format.
static final String	PATTERN_RFC1036	Date format pattern used to parse HTTP date headers in RFC 1036 format.
static final String	PATTERN_RFC1123	Date format pattern used to parse HTTP date headers in RFC 1123 format.

Method Summary

Modifier and Type	Method	Description
static int	convertDateToDayInteger(Date theDateValue)
static String	convertDateToIso8601String(Date theDateValue)
static String	formatDate(Date date)	Formats the given date according to the RFC 1123 pattern.
static org.apache.commons.lang3.tuple.Pair<String,String>	getCompletedDate(String theIncompleteDateStr)	Convert an incomplete date e.g.
static Date	getEndOfDay(Date theDate)
static Date	getHighestInstantFromDate(Date theDateValue)
static Date	getLowestInstantFromDate(Date theDateValue)
static <T> T	notNull(T argument, String name)
static Date	parseDate(String theDateValue)	Parses a date value.

Methods inherited from class java.lang.Object

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

Field Details

GMT

public static final TimeZone GMT

GMT TimeZone

PATTERN_RFC1123

public static final String PATTERN_RFC1123

Date format pattern used to parse HTTP date headers in RFC 1123 format.

See Also:

• Constant Field Values

PATTERN_RFC1036

public static final String PATTERN_RFC1036

Date format pattern used to parse HTTP date headers in RFC 1036 format.

See Also:

• Constant Field Values

PATTERN_ASCTIME

public static final String PATTERN_ASCTIME

Date format pattern used to parse HTTP date headers in ANSI C asctime() format.

See Also:

• Constant Field Values

Method Details

parseDate

public static Date parseDate(String theDateValue)

Parses a date value. The formats used for parsing the date value are retrieved from the default http params.

Parameters:

theDateValue - the date value to parse

Returns:

the parsed date or null if input could not be parsed

getHighestInstantFromDate

public static Date getHighestInstantFromDate(Date theDateValue)

getLowestInstantFromDate

public static Date getLowestInstantFromDate(Date theDateValue)

convertDateToDayInteger

public static int convertDateToDayInteger(Date theDateValue)

convertDateToIso8601String

public static String convertDateToIso8601String(Date theDateValue)

formatDate

public static String formatDate(Date date)

Formats the given date according to the RFC 1123 pattern.

Parameters:

date - The date to format.

Returns:

An RFC 1123 formatted date string.

See Also:

• PATTERN_RFC1123

notNull

public static <T> T notNull(T argument,
 String name)

getCompletedDate

public static org.apache.commons.lang3.tuple.Pair<String,String> getCompletedDate(String theIncompleteDateStr)

Convert an incomplete date e.g. 2020 or 2020-01 to a complete date with lower bound to the first day of the year/month, and upper bound to the last day of the year/month e.g. 2020 to 2020-01-01 (left), 2020-12-31 (right) 2020-02 to 2020-02-01 (left), 2020-02-29 (right)

Parameters:

theIncompleteDateStr - 2020 or 2020-01

Returns:

a pair of complete date, left is lower bound, and right is upper bound

getEndOfDay

public static Date getEndOfDay(Date theDate)