de.gerdiproject.json

Class DateUtils

java.lang.Object

de.gerdiproject.json.DateUtils

public class DateUtils
extends Object

This utility class offers static methods for processing dates.

Author:

Robin Weiss

Method Summary

Modifier and Type	Method and Description
static AbstractDate	parseAbstractDate(String dateString, DateType type) Parses an AbstractDate from a specified date string.
static Instant	parseDate(String dateString) Attempts to parse a date from a String.
static Instant[]	parseDateRange(String dateString) Parses a date range using a set of common separators defined in DataCiteDateConstants.
static Instant[]	parseDateRange(String dateString, String separator) Parses a date range considering a specified separator.
static Instant	unixTimestampToInstant(long epochMilli) Creates an instant using the amount of milliseconds that passed from 01/01/1970 00:00:00 until this date.

Methods inherited from class java.lang.Object

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

Method Detail

unixTimestampToInstant

public static Instant unixTimestampToInstant(long epochMilli)

Creates an instant using the amount of milliseconds that passed from 01/01/1970 00:00:00 until this date.

Parameters:

epochMilli - the amount of milliseconds between 01/01/1970 00:00:00 and this date

Returns:

an Instant that represents the timestamp

parseDateRange

public static Instant[] parseDateRange(String dateString)

Parses a date range using a set of common separators defined in DataCiteDateConstants.

Parameters:

dateString - a raw String that contains a date range

Returns:

an Instant array that contains the start- and end date, or null if no date range could be parsed

parseDateRange

public static Instant[] parseDateRange(String dateString,
                                       String separator)

Parses a date range considering a specified separator.

Parameters:

dateString - a raw String that contains a date range

separator - a sub-string that separates the beginning from the end date

Returns:

an Instant array that contains the start- and end date, or null if no date range could be parsed

parseDate

public static Instant parseDate(String dateString)

Attempts to parse a date from a String. The string is stripped of HTML tags and trimmed prior to being divided into parts. Each part is then parsed in order to obtain a year, a month and a day.
If a date such as 01/02/2000 is parsed, it is assumed that the first number represents the day.
If a date such as 2000/02/01 is parsed, it is assumed that the last number is the day.
Month names and abbreviations thereof are parsed in English.

Parameters:

dateString - a text containing a date

Returns:

an Instant or null, if nothing was parsed

parseAbstractDate

public static AbstractDate parseAbstractDate(String dateString,
                                             DateType type)

Parses an AbstractDate from a specified date string.

Parameters:

dateString - a raw string that contains a Date or DateRange

type - the DateType of the retrieved date

Returns:

a Date, DateRange, or null if no date could be parsed