Class JulianDayDateTime

java.lang.Object

net.okapia.osid.primordium.calendaring.datetime.spi.AbstractDateTime

net.okapia.osid.primordium.calendaring.datetime.spi.AbstractConfigurableDateTime

net.okapia.osid.primordium.calendaring.datetime.spi.AbstractDayCountDateTime

net.okapia.osid.primordium.calendaring.datetime.counting.JulianDayDateTime

All Implemented Interfaces:

Serializable, Comparable<DateTime>, DateTime, OsidPrimitive, DateTime, OsidPrimitive

public final class JulianDayDateTime
extends AbstractDayCountDateTime

A Julian Day: a count of days, the Julian Day Number itself. A day count with no time of day; it renders as the bare count.

See Also:

• JulianDayCalendar
• NoTimeSystemTimeDefinition
• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	JulianDayDateTime.JulianDayDateTimeFactory	The factory for JulianDayDateTimes.
static class	JulianDayDateTime.JulianDayDateTimeSpecifier	The specifier for JulianDayDateTimes.

Field Summary

Fields

Modifier and Type	Field	Description
protected static final Type	CALENDAR_TYPE	the OSID Type

Fields inherited from class AbstractConfigurableDateTime

GREGORIAN_REFORM, YEARS_PER_BLUEMOON

Modifier and Type	Field	Description
protected static final Instant	GREGORIAN_REFORM	the gregorian reform
static final BigDecimal	YEARS_PER_BLUEMOON	the years per bluemoon

Constructor Summary

Constructors

Constructor	Description
JulianDayDateTime(JulianDayDateTime.JulianDayDateTimeSpecifier specifier)	Constructs a new JulianDayDateTime.

Method Summary

Modifier and Type	Method	Description
static DateTime	datetime(long count)	Creates a Julian Day from a count.
static DateTime	now()	Gets the Julian Day for today (UTC).
static DateTime	valueOf(long count)	Creates a Julian Day from a count.

Methods inherited from class AbstractDayCountDateTime

atCount, currentCount, getCount, toString

Modifier and Type	Method	Description
protected static AbstractConfigurableDateTimeSpecifier	atCount(AbstractConfigurableDateTimeSpecifier specifier, long count)	Populates a specifier at a count: a year and month of zero and the count in the day, giving day resolution.
protected static long	currentCount(CalendarInfo calendar)	Gets the count for today (UTC) in the given day-count calendar, by way of the shared day-number timeline.
long	getCount()	Gets the count of days carried by this date.
String	toString()	Renders the bare count.

Methods inherited from class AbstractConfigurableDateTime

compare, compareTo, denormalize, equals, formatDigits, formatNumber, formatYear, fromComponents, fromInstant, fromLocalDateTime, fromOffsetDateTime, fromZonedDateTime, getDateTimeFactory, getTime, getWeek, hashCode, isExclusive, isGreater, isInclusive, isLess, minus, minus, parse, parseISO, plus, plus, requireResolution, toLocaleDateString, toLocaleTimeString, toShortLocaleDateString, toTime, toTimeString

Modifier and Type	Method	Description
protected static int	compare(DateTime dt1, DateTime dt2, DateTimeFactory factory)	Compares two normalized finite datetimes.
int	compareTo(DateTime datetime)	Compares this DateTime with the specified DateTime for ordering.
final DateTimeInterval	denormalize()	Returns an interval based on this DateTime derived by its granularity and uncertainty.
final boolean	equals(Object obj)	Determines if the given Time is equal to this one.
protected static String	formatDigits(long num, int n)	Formats a number, zero-padded to a minimum number of digits.
protected static String	formatNumber(long num)	Formats a number as an ordinal (1st, 2nd, 3rd, ...).
protected static String	formatYear(long year)	Formats a year for display, zero-padded to four digits within the common range.
protected static DateTime	fromComponents(DateTimeFactory factory, long year, long month, long day, Time time)	Builds a DateTime from explicit calendar components.
protected static DateTime	fromInstant(DateTimeFactory factory, Instant instant, DateTimeResolution granularity)	Converts a Java Instant to a DateTime.
protected static DateTime	fromLocalDateTime(DateTimeFactory factory, LocalDateTime ldt, DateTimeResolution granularity)	Converts a Java LocalDateTime to a DateTime, treating the value as already in UTC.
protected static DateTime	fromOffsetDateTime(DateTimeFactory factory, OffsetDateTime odt, DateTimeResolution granularity)	Converts a Java OffsetDateTime to a DateTime, adjusting to UTC.
protected static DateTime	fromZonedDateTime(DateTimeFactory factory, ZonedDateTime zdt, DateTimeResolution granularity)	Converts a Java ZonedDateTime to a DateTime, adjusting to UTC.
protected DateTimeFactory	getDateTimeFactory()	Gets the datetime factory.
protected Time	getTime()	Gets the time component.
final long	getWeek()	Gets the week of the year, counting from one.
final int	hashCode()	Returns a hash code value for this Time based on the type, granularity and values.
final boolean	isExclusive(DateTime datetime)	Tests if the range of this DateTime, as specified by its granularity and uncertainty, does not overlap with the given DateTime.
boolean	isGreater(DateTime datetime)	Tests if this DateTime is greater than the given DateTime.
final boolean	isInclusive(DateTime datetime)	Tests if the range of this DateTime, as specified by its granularity and uncertainty, includes the given DateTime ranged by its grabularity and uncertainty.
final boolean	isLess(DateTime datetime)	Tests if this DateTime is less than the given DateTime.
DateTime	minus(long amount, DateTimeResolution unit)	Subtracts a number of a resolution's units from this datetime.
DateTime	minus(Duration duration)	Subtracts a duration from this datetime.
protected static DateTime	parse(DateTimeFactory factory, String string)	Parses the okapia-extended datetime form: a strict ISO datetime optionally trailed by an uncertainty (" ±n unit" / " +p -m unit", with an optional "exclusive"), or the standalone "?" (unknown) and "infinity".
protected static DateTime	parseISO(DateTimeFactory factory, String iso)	Parses an ISO date string.
DateTime	plus(long amount, DateTimeResolution unit)	Adds a number of a resolution's units to this datetime, in its own calendar.
DateTime	plus(Duration duration)	Adds a duration to this datetime, applying its calendar components (years, months, weeks, days) and clock components (hours, minutes, seconds) in this datetime's own calendar.
protected static void	requireResolution(DateTimeResolution granularity, DateTimeResolution floor, String source)	Verifies that a requested resolution is no finer than the source's own precision, so a conversion does not fabricate digits the source cannot supply -- e.g.
DisplayText	toLocaleDateString()	Renders the date in a long locale form using the calendar's own month names -- the Gregorian form, for example, is "January 31, 2020", and at month granularity "January 2020".
DisplayText	toLocaleTimeString()	Renders the time in a locale form.
DisplayText	toShortLocaleDateString()	Renders the date in a short locale form, abbreviating the month name -- the Gregorian form is "31 Jan 2020", and at month granularity "Jan 2020".
Time	toTime()	Gets the time of day as a Time.
DisplayText	toTimeString()	Renders the time of day, or the empty string when this datetime has no time component (a granularity of a day or coarser).

Methods inherited from class AbstractDateTime

coarsePeriodYears, definesUncertainty, getAeon, getAttoseconds, getCalendarType, getCentury, getDay, getEpoch, getFemtoseconds, getGranularity, getGranularityMultiplier, getHour, getMicroquectoseconds, getMicroseconds, getMillennium, getMilliquectoseconds, getMilliseconds, getMinute, getMonth, getNanoseconds, getPicoseconds, getPlanckseconds, getQuectoseconds, getRontoseconds, getSecond, getTimeType, getUncertaintyMinus, getUncertaintyPlus, getUncertaintyUnits, getYear, getYoctoseconds, getZeptoseconds, isUncertaintyDateInclusive, rawDay, referenceYear

Modifier and Type	Method	Description
protected long[]	coarsePeriodYears()	Gets the first and last year of this value's coarse period.
final boolean	definesUncertainty()	Tests if uncertainty is defined for this time.
final long	getAeon()	Gets the aeon.
final long	getAttoseconds()	Gets the number of attoseconds of the femtoseconds 0-999.
final Type	getCalendarType()	Gets the calendar type.
final long	getCentury()	Gets the century.
final long	getDay()	Gets the day of the month.
final long	getEpoch()	Gets the epoch.
final long	getFemtoseconds()	Gets the number of femtoseconds of the picosecond 0-999.
final DateTimeResolution	getGranularity()	Gets the granularity of this time.
final long	getGranularityMultiplier()	If the granularity of the time equals getGranularity(), then the multiplier is 1.
final long	getHour()	Gets the hour of the day.
final long	getMicroquectoseconds()	Gets the number of undaseconds of the vatosecond 0-999.
final long	getMicroseconds()	Gets the number of microseconds of the second 0-999.
final long	getMillennium()	Gets the millennium.
final long	getMilliquectoseconds()	Gets the number of vatoseconds of the xoxxosecond 0-999.
final long	getMilliseconds()	Gets the number of milliseconds in this second 0-999.
final long	getMinute()	Gets the minute of the hour.
final long	getMonth()	Gets the month.
final long	getNanoseconds()	Gets the number of nanoseconds of the microsecond 0-999.
final long	getPicoseconds()	Gets the number of picoseconds of the nanosecond 0-999.
final long	getPlanckseconds()	Gets the number of Plancks of the vatoseconds.
final long	getQuectoseconds()	Gets the number of weebleseconds of the xoxxosecond 0-999.
final long	getRontoseconds()	Gets the number of xoxxoseconds of the yoctosecond 0-999.
final long	getSecond()	Gets the second of the minute.
final Type	getTimeType()	Gets the time type.
final long	getUncertaintyMinus()	Gets the uncertainty of this time in the negative direction.
final long	getUncertaintyPlus()	Gets the uncertainty of this time in the positive direction.
final DateTimeResolution	getUncertaintyUnits()	Gets the units of the uncertainty.
final long	getYear()	Gets the year.
final long	getYoctoseconds()	Gets the number of yoctoseconds of the picosecond 0-999.
final long	getZeptoseconds()	Gets the number of zeptoseconds of the attosecond 0-999.
boolean	isUncertaintyDateInclusive()	Tests if the uncertainty is inclusive of all dates.
protected final long	rawDay()	Gets the stored day of the month, ungated by granularity.
protected long	referenceYear()	Gets a year within this value's period, from which the coarser fields are derived.

Methods inherited from class Object

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

Field Details

CALENDAR_TYPE

protected static final Type CALENDAR_TYPE

the OSID Type

Constructor Details

JulianDayDateTime

public JulianDayDateTime(JulianDayDateTime.JulianDayDateTimeSpecifier specifier)

Constructs a new JulianDayDateTime.

Parameters:

specifier - a datetime specifier

Throws:

NullArgumentException - specifier is null

Method Details

valueOf

public static DateTime valueOf(long count)

Creates a Julian Day from a count.

Parameters:

count - the day count

Returns:

a Julian Day datetime

datetime

public static DateTime datetime(long count)

Creates a Julian Day from a count. Equivalent to valueOf(long).

Parameters:

count - the day count

Returns:

a Julian Day datetime

now

public static DateTime now()

Gets the Julian Day for today (UTC).

Returns:

today's Julian Day