org.wikidata.query.rdf.common

Class WikibaseDate

java.lang.Object

org.wikidata.query.rdf.common.WikibaseDate

public class WikibaseDate
extends Object

Handles wikidata dates. Note that this ignores leap seconds. This isn't ok but its what joda time does so it where we're starting.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WikibaseDate.ToStringFormat Format for toString.

Constructor Summary

Constructors

Constructor and Description
WikibaseDate(long year, int month, int day, int hour, int minute, int second) Build using explicit date parts.

Method Summary

Methods

Modifier and Type	Method and Description
WikibaseDate	addDuration(Duration d) Add Duration to time value.
WikibaseDate	cleanWeirdStuff() Wikidata contains some odd dates like -13798000000-00-00T00:00:00Z and February 30th.
int	day() Day component of the date.
boolean	equals(Object obj)
static WikibaseDate	fromSecondsSinceEpoch(long secondsSinceEpoch) Build a WikibaseDate from seconds since epoch.
static WikibaseDate	fromString(String string) Build a WikibaseDate from the string representation.
int	hashCode()
int	hour() Hour component of the date.
int	minute() Minute component of the date.
int	month() Month component of the date.
int	second() Second component of the date.
long	secondsSinceEpoch() Convert this date into a number of seconds since epoch.
String	toString()
String	toString(WikibaseDate.ToStringFormat format) Build a WikibaseDate from the string representation.
long	year() Year component of the date.

Methods inherited from class java.lang.Object

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

Constructor Detail

WikibaseDate

public WikibaseDate(long year,
            int month,
            int day,
            int hour,
            int minute,
            int second)

Build using explicit date parts.

Method Detail

fromString

public static WikibaseDate fromString(String string)

Build a WikibaseDate from the string representation. Supported:

• +YYYYYYYYYYYY-MM-DDThh:mm:ssZ (Wikidata's default)
• YYYY-MM-DDThh:mm:ssZ (xsd:dateTime)
• YYYY-MM-DD (xsd:date with time assumed to be 00:00:00)

fromSecondsSinceEpoch

public static WikibaseDate fromSecondsSinceEpoch(long secondsSinceEpoch)

Build a WikibaseDate from seconds since epoch.

cleanWeirdStuff

public WikibaseDate cleanWeirdStuff()

Wikidata contains some odd dates like -13798000000-00-00T00:00:00Z and February 30th. We simply guess what they mean here. Note that we really can't be sure what was really ment so these just amount to a best effort.

Returns:

this if the date is fine, a new date if we modified it

secondsSinceEpoch

public long secondsSinceEpoch()

Convert this date into a number of seconds since epoch.

toString

public String toString(WikibaseDate.ToStringFormat format)

Build a WikibaseDate from the string representation. See ToStringFormat for more.

toString

public String toString()

Overrides:

toString in class Object

year

public long year()

Year component of the date.

month

public int month()

Month component of the date.

day

public int day()

Day component of the date.

hour

public int hour()

Hour component of the date.

minute

public int minute()

Minute component of the date.

second

public int second()

Second component of the date.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

addDuration

public WikibaseDate addDuration(Duration d)

Add Duration to time value.

Parameters:

d -