de.gerdiproject.json.datacite.abstr

Class AbstractDate

java.lang.Object

de.gerdiproject.json.datacite.abstr.AbstractDate

Direct Known Subclasses:

Date, DateRange

public abstract class AbstractDate
extends Object

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

Modifier and Type	Field and Description
protected static org.slf4j.Logger	LOGGER

Constructor Summary

Constructors

Constructor and Description
AbstractDate(DateType type) Simple constructor that requires all mandatory fields.

Method Summary

Modifier and Type	Method and Description
String	getDateInformation() Returns specific free text information about the date.
DateType	getType() Returns the event that is marked by this date.
abstract String	getValue() Returns the value of the date.
void	setDateInformation(String dateInformation) Changes the specific free text information about the date.
void	setType(DateType type) Changes the event that is marked by this date.
abstract void	setValue(String value) Changes the date value.
protected static Instant	stringToInstant(String stringValue) Tries to parse a String to a date.
protected 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

Field Detail

LOGGER

protected static final org.slf4j.Logger LOGGER

Constructor Detail

AbstractDate

public AbstractDate(DateType type)

Simple constructor that requires all mandatory fields.

Parameters:

type - the event that is marked by this date

Method Detail

getValue

public abstract String getValue()

Returns the value of the date. In XML, this is the value between the date-tags.

Returns:

the value of the date

setValue

public abstract void setValue(String value)

Changes the date value. In XML, this is the value between the date-tags.

Parameters:

value - the new value

getType

public DateType getType()

Returns the event that is marked by this date.

Returns:

the event that is marked by this date

setType

public void setType(DateType type)

Changes the event that is marked by this date.

Parameters:

type - the event that is marked by this date

getDateInformation

public String getDateInformation()

Returns specific free text information about the date.

Returns:

specific free text information about the date

setDateInformation

public void setDateInformation(String dateInformation)

Changes the specific free text information about the date.

Parameters:

dateInformation - specific free text information about the date

stringToInstant

protected static Instant stringToInstant(String stringValue)

Tries to parse a String to a date. Ideally, the string is ISO 8601 compliant.
e.g. 1994-11-05T13:15:30Z

(see https://www.w3.org/TR/NOTE-datetime)

Parameters:

stringValue - the String that is to be parsed

Returns:

an Instant that represents the string value

unixTimestampToInstant

protected 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