de.gerdiproject.json.datacite

Class DateRange

java.lang.Object

de.gerdiproject.json.datacite.abstr.AbstractDate

de.gerdiproject.json.datacite.DateRange

public class DateRange
extends AbstractDate

This JsonObject describes a date that has been relevant to the work. Source: https://schema.datacite.org/meta/kernel-4.1/doc/DataCite-MetadataKernel_v4.1.pdf

Author:

Mathis Neumann, Robin Weiss

Field Summary

Fields inherited from class de.gerdiproject.json.datacite.abstr.AbstractDate

LOGGER

Constructor Summary

Constructors

Constructor and Description
DateRange(long epochMilliSince, long epochMilliUntil, DateType type) Simple constructor that requires all mandatory fields.
DateRange(String dateString, DateType type) Simple constructor that requires all mandatory fields.
DateRange(String rangeFrom, String rangeUntil, DateType type) Simple constructor that requires all mandatory fields.

Method Summary

Modifier and Type	Method and Description
String	getValue() Returns the date as a Dublin-Core-compliant String.
void	setRangeFrom(long epochMilli) Changes the since-value using the amount of milliseconds that passed from 01/01/1970 00:00:00 until this date.
void	setRangeFrom(String stringValue) Changes the since-value by parsing a date-string.
void	setRangeUntil(long epochMilli) Changes the until-value using the amount of milliseconds that passed from 01/01/1970 00:00:00 until this date.
void	setRangeUntil(String stringValue) Changes the since-value by parsing a date-string.
void	setValue(String stringValue) Tries to set the date by parsing a Dublin-Core-compliant String.

Methods inherited from class de.gerdiproject.json.datacite.abstr.AbstractDate

getDateInformation, getType, setDateInformation, setType, stringToInstant, unixTimestampToInstant

Methods inherited from class java.lang.Object

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

Constructor Detail

DateRange

public DateRange(String dateString,
                 DateType type)

Simple constructor that requires all mandatory fields.

Parameters:

dateString - a Dublin-Core-compliant String

type - the event that is marked by this date range

DateRange

public DateRange(long epochMilliSince,
                 long epochMilliUntil,
                 DateType type)

Simple constructor that requires all mandatory fields.

Parameters:

epochMilliSince - milliseconds that passed since 01/01/1970 00:00:00 until the beginning of the range

epochMilliUntil - milliseconds that passed since 01/01/1970 00:00:00 until the end of the range

type - the event that is marked by this date range

DateRange

public DateRange(String rangeFrom,
                 String rangeUntil,
                 DateType type)

Simple constructor that requires all mandatory fields.

Parameters:

rangeFrom - a Dublin-Core-compliant String that marks the beginning of the range, or null if there is no beginning

rangeUntil - a Dublin-Core-compliant String that marks the end of the range, or null if ther is no end

type - the event that is marked by this date range

Method Detail

getValue

public String getValue()

Returns the date as a Dublin-Core-compliant String.
e.g. 1997-07-16T19:30Z/1997-07-17T15:30Z

(see http://www.ukoln.ac.uk/metadata/dcmi/collection-RKMS-ISO8601/)

Specified by:

getValue in class AbstractDate

Returns:

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

setValue

public void setValue(String stringValue)

Tries to set the date by parsing a Dublin-Core-compliant String.
e.g. 1997-07-16T19:30Z/1997-07-17T15:30Z

(see http://www.ukoln.ac.uk/metadata/dcmi/collection-RKMS-ISO8601/)

Specified by:

setValue in class AbstractDate

Parameters:

stringValue - the String that is to be parsed

setRangeFrom

public void setRangeFrom(long epochMilli)

Changes the since-value 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

setRangeFrom

public void setRangeFrom(String stringValue)

Changes the since-value by parsing a date-string.

Parameters:

stringValue - a date string that represents the start-date

setRangeUntil

public void setRangeUntil(long epochMilli)

Changes the until-value 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

setRangeUntil

public void setRangeUntil(String stringValue)

Changes the since-value by parsing a date-string.

Parameters:

stringValue - a date string that represents the end-date