de.gerdiproject.json.datacite

Class Date

java.lang.Object

de.gerdiproject.json.datacite.abstr.AbstractDate

de.gerdiproject.json.datacite.Date

All Implemented Interfaces:

ICleanable

public class Date
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

Constructor Summary

Constructors

Constructor and Description
Date(long epochMilli, DateType type) Simple constructor that requires all mandatory fields.
Date(String dateString, DateType type) Simple constructor that requires all mandatory fields.

Method Summary

Modifier and Type	Method and Description
protected boolean	canEqual(Object other)
boolean	equals(Object o)
String	getValue() Returns the date as ISO-8601-compliant String.
ZonedDateTime	getValueAsDateTime() Retrieves the value as ZonedDateTime, allowing for subsequent operations such as retrieving the year.
int	hashCode()
void	setDate(Instant date) Changes the date value using an Instant that marks a date.
void	setDate(long epochMilli) Changes the date value using the amount of milliseconds that passed from 01/01/1970 00:00:00 until this date.
void	setValue(String stringValue) Tries to set the date by parsing an ISO 8601 compliant String.
String	toString()

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

clean, getInformation, getType, setInformation

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Date

public Date(String dateString,
            DateType type)

Simple constructor that requires all mandatory fields.

Parameters:

dateString - a ISO-8601-compliant date string

type - the event that is marked by this date

Date

public Date(long epochMilli,
            DateType type)

Simple constructor that requires all mandatory fields.

Parameters:

epochMilli - milliseconds that passed since 01/01/1970 00:00:00

type - the event that is marked by this date

Method Detail

getValue

public String getValue()

Returns the date as ISO-8601-compliant String.
e.g. 1994-11-05T13:15:30Z

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

Specified by:

getValue in class AbstractDate

Returns:

the date as ISO-8601-compliant String, or null if the date is invalid

getValueAsDateTime

public ZonedDateTime getValueAsDateTime()

Retrieves the value as ZonedDateTime, allowing for subsequent operations such as retrieving the year.

Returns:

the value as ZonedDateTime

setValue

public void setValue(String stringValue)

Tries to set the date by parsing an ISO 8601 compliant String.
e.g. 1994-11-05T13:15:30Z

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

Specified by:

setValue in class AbstractDate

Parameters:

stringValue - the String that is to be parsed

setDate

public void setDate(long epochMilli)

Changes the date 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

setDate

public void setDate(Instant date)

Changes the date value using an Instant that marks a date.

Parameters:

date - an Instant that represents the new date

equals

public boolean equals(Object o)

Overrides:

equals in class AbstractDate

canEqual

protected boolean canEqual(Object other)

Overrides:

canEqual in class AbstractDate

hashCode

public int hashCode()

Overrides:

hashCode in class AbstractDate

toString

public String toString()

Overrides:

toString in class AbstractDate