Module com.aoapps.tldparser

Package com.aoapps.tldparser

Class Dates

java.lang.Object

com.aoapps.tldparser.Dates

public class Dates
extends Object

TLD files may provide dates within special comments inside the XML.

1. <!-- dateCreated = "ISO 8601" -->: getCreated()
2. <!-- datePublished = "ISO 8601" -->: getPublished()
3. <!-- dateModified = "ISO 8601" -->: getModified()
4. <!-- dateReviewed = "ISO 8601" -->: getReviewed()

Field Summary

Fields

Modifier and Type	Field	Description
static final Dates	UNKNOWN	A constant for a set of unknown dates.

Method Summary

Modifier and Type	Method	Description
static Dates	fromComments(Element elem, Dates defaultDates)	Parses dates from within direct child comments of the given element.
ZonedDateTime	getCreated()	https://schema.org/dateCreated.
ZonedDateTime	getModified()	https://schema.org/dateModified.
ZonedDateTime	getPublished()	https://schema.org/datePublished.
ZonedDateTime	getReviewed()	This has no equivalent in https://schema.org/, however we feel it is important to actively review content to ensure its accuracy, even when it has not been modified.
static Dates	valueOf(ZonedDateTime created, ZonedDateTime published, ZonedDateTime modified, ZonedDateTime reviewed)	Gets or creates an instance of Dates.

Methods inherited from class java.lang.Object

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

Field Details

UNKNOWN

public static final Dates UNKNOWN

A constant for a set of unknown dates.

Method Details

valueOf

public static Dates valueOf(ZonedDateTime created,
 ZonedDateTime published,
 ZonedDateTime modified,
 ZonedDateTime reviewed)

Gets or creates an instance of Dates.

fromComments

public static Dates fromComments(Element elem,
 Dates defaultDates)

Parses dates from within direct child comments of the given element.

Parameters:

elem - The element to find direct child comments of

defaultDates - The optional default dates for when no date-comments found

getCreated

public ZonedDateTime getCreated()

https://schema.org/dateCreated.

See Also:

• When created and published are the same date, prefer published because it seems to have more use overall than created.

getPublished

public ZonedDateTime getPublished()

https://schema.org/datePublished.

See Also:

• When created and published are the same date, prefer published because it seems to have more use overall than created.

getModified

public ZonedDateTime getModified()

https://schema.org/dateModified.

getReviewed

public ZonedDateTime getReviewed()

This has no equivalent in https://schema.org/, however we feel it is important to actively review content to ensure its accuracy, even when it has not been modified.