org.threeten.extra.chrono.JulianDate Maven / Gradle / Ivy
Show all versions of threeten-extra Show documentation
/*
* Copyright (c) 2007-present, Stephen Colebourne & Michael Nascimento Santos
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
*
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* * Neither the name of JSR-310 nor the names of its contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
package org.threeten.extra.chrono;
import static java.time.temporal.ChronoField.DAY_OF_MONTH;
import static java.time.temporal.ChronoField.DAY_OF_YEAR;
import static java.time.temporal.ChronoField.EPOCH_DAY;
import static java.time.temporal.ChronoField.MONTH_OF_YEAR;
import static java.time.temporal.ChronoField.YEAR;
import java.io.Serializable;
import java.time.Clock;
import java.time.DateTimeException;
import java.time.LocalDate;
import java.time.LocalTime;
import java.time.Month;
import java.time.ZoneId;
import java.time.chrono.ChronoLocalDate;
import java.time.chrono.ChronoLocalDateTime;
import java.time.chrono.ChronoPeriod;
import java.time.temporal.ChronoField;
import java.time.temporal.Temporal;
import java.time.temporal.TemporalAccessor;
import java.time.temporal.TemporalAdjuster;
import java.time.temporal.TemporalAmount;
import java.time.temporal.TemporalField;
import java.time.temporal.TemporalQuery;
import java.time.temporal.TemporalUnit;
import java.time.temporal.ValueRange;
/**
* A date in the Julian calendar system.
*
* This date operates using the {@linkplain JulianChronology Julian calendar}.
* This calendar system is the forerunner to the modern Gregorian and ISO calendars.
* The Julian differs from the Gregorian only in terms of the leap year rule.
* Dates are aligned such that {@code 0001-01-01 (Julian)} is {@code 0000-12-30 (ISO)}.
*
*
Implementation Requirements
* This class is immutable and thread-safe.
*
* This class must be treated as a value type. Do not synchronize, rely on the
* identity hash code or use the distinction between equals() and ==.
*/
public final class JulianDate
extends AbstractDate
implements ChronoLocalDate, Serializable {
/**
* Serialization version.
*/
private static final long serialVersionUID = -7920528871688876868L;
/**
* The difference between the ISO and Julian epoch day count (Julian 0001-01-01 to ISO 1970-01-01).
*/
private static final int JULIAN_0001_TO_ISO_1970 = 678577 + 40587; // MJD values
/**
* The days per 4 year cycle.
*/
private static final int DAYS_PER_CYCLE = (365 * 4) + 1;
/**
* The proleptic year.
*/
private final int prolepticYear;
/**
* The month.
*/
private final short month;
/**
* The day.
*/
private final short day;
//-----------------------------------------------------------------------
/**
* Obtains the current {@code JulianDate} from the system clock in the default time-zone.
*
* This will query the {@link Clock#systemDefaultZone() system clock} in the default
* time-zone to obtain the current date.
*
* Using this method will prevent the ability to use an alternate clock for testing
* because the clock is hard-coded.
*
* @return the current date using the system clock and default time-zone, not null
*/
public static JulianDate now() {
return now(Clock.systemDefaultZone());
}
/**
* Obtains the current {@code JulianDate} from the system clock in the specified time-zone.
*
* This will query the {@link Clock#system(ZoneId) system clock} to obtain the current date.
* Specifying the time-zone avoids dependence on the default time-zone.
*
* Using this method will prevent the ability to use an alternate clock for testing
* because the clock is hard-coded.
*
* @param zone the zone ID to use, not null
* @return the current date using the system clock, not null
*/
public static JulianDate now(ZoneId zone) {
return now(Clock.system(zone));
}
/**
* Obtains the current {@code JulianDate} from the specified clock.
*
* This will query the specified clock to obtain the current date - today.
* Using this method allows the use of an alternate clock for testing.
* The alternate clock may be introduced using {@linkplain Clock dependency injection}.
*
* @param clock the clock to use, not null
* @return the current date, not null
* @throws DateTimeException if the current date cannot be obtained
*/
public static JulianDate now(Clock clock) {
LocalDate now = LocalDate.now(clock);
return JulianDate.ofEpochDay(now.toEpochDay());
}
/**
* Obtains a {@code JulianDate} representing a date in the Julian calendar
* system from the proleptic-year, month-of-year and day-of-month fields.
*
* This returns a {@code JulianDate} with the specified fields.
* The day must be valid for the year and month, otherwise an exception will be thrown.
*
* @param prolepticYear the Julian proleptic-year
* @param month the Julian month-of-year, from 1 to 12
* @param dayOfMonth the Julian day-of-month, from 1 to 31
* @return the date in Julian calendar system, not null
* @throws DateTimeException if the value of any field is out of range,
* or if the day-of-month is invalid for the month-year
*/
public static JulianDate of(int prolepticYear, int month, int dayOfMonth) {
return JulianDate.create(prolepticYear, month, dayOfMonth);
}
/**
* Obtains a {@code JulianDate} from a temporal object.
*
* This obtains a date in the Julian calendar system based on the specified temporal.
* A {@code TemporalAccessor} represents an arbitrary set of date and time information,
* which this factory converts to an instance of {@code JulianDate}.
*
* The conversion typically uses the {@link ChronoField#EPOCH_DAY EPOCH_DAY}
* field, which is standardized across calendar systems.
*
* This method matches the signature of the functional interface {@link TemporalQuery}
* allowing it to be used as a query via method reference, {@code JulianDate::from}.
*
* @param temporal the temporal object to convert, not null
* @return the date in Julian calendar system, not null
* @throws DateTimeException if unable to convert to a {@code JulianDate}
*/
public static JulianDate from(TemporalAccessor temporal) {
if (temporal instanceof JulianDate) {
return (JulianDate) temporal;
}
return JulianDate.ofEpochDay(temporal.getLong(EPOCH_DAY));
}
//-----------------------------------------------------------------------
/**
* Obtains a {@code JulianDate} representing a date in the Julian calendar
* system from the proleptic-year and day-of-year fields.
*
* This returns a {@code JulianDate} with the specified fields.
* The day must be valid for the year, otherwise an exception will be thrown.
*
* @param prolepticYear the Julian proleptic-year
* @param dayOfYear the Julian day-of-year, from 1 to 366
* @return the date in Julian calendar system, not null
* @throws DateTimeException if the value of any field is out of range,
* or if the day-of-year is invalid for the year
*/
static JulianDate ofYearDay(int prolepticYear, int dayOfYear) {
JulianChronology.YEAR_RANGE.checkValidValue(prolepticYear, YEAR);
DAY_OF_YEAR.checkValidValue(dayOfYear);
boolean leap = JulianChronology.INSTANCE.isLeapYear(prolepticYear);
if (dayOfYear == 366 && leap == false) {
throw new DateTimeException("Invalid date 'DayOfYear 366' as '" + prolepticYear + "' is not a leap year");
}
Month moy = Month.of((dayOfYear - 1) / 31 + 1);
int monthEnd = moy.firstDayOfYear(leap) + moy.length(leap) - 1;
if (dayOfYear > monthEnd) {
moy = moy.plus(1);
}
int dom = dayOfYear - moy.firstDayOfYear(leap) + 1;
return new JulianDate(prolepticYear, moy.getValue(), dom);
}
/**
* Obtains a {@code JulianDate} representing a date in the Julian calendar
* system from the epoch-day.
*
* @param epochDay the epoch day to convert based on 1970-01-01 (ISO)
* @return the date in Julian calendar system, not null
* @throws DateTimeException if the epoch-day is out of range
*/
static JulianDate ofEpochDay(final long epochDay) {
EPOCH_DAY.range().checkValidValue(epochDay, EPOCH_DAY); // validate outer bounds
// use of Julian 0001 makes leap year at end of cycle
long julianEpochDay = epochDay + JULIAN_0001_TO_ISO_1970;
long cycle = Math.floorDiv(julianEpochDay, DAYS_PER_CYCLE);
long daysInCycle = Math.floorMod(julianEpochDay, DAYS_PER_CYCLE);
if (daysInCycle == DAYS_PER_CYCLE - 1) {
int year = (int) ((cycle * 4 + 3) + 1);
return ofYearDay(year, 366);
}
int year = (int) ((cycle * 4 + daysInCycle / 365) + 1);
int doy = (int) ((daysInCycle % 365) + 1);
return ofYearDay(year, doy);
}
private static JulianDate resolvePreviousValid(int prolepticYear, int month, int day) {
switch (month) {
case 2:
day = Math.min(day, JulianChronology.INSTANCE.isLeapYear(prolepticYear) ? 29 : 28);
break;
case 4:
case 6:
case 9:
case 11:
day = Math.min(day, 30);
break;
default:
break;
}
return new JulianDate(prolepticYear, month, day);
}
/**
* Creates a {@code JulianDate} validating the input.
*
* @param prolepticYear the Julian proleptic-year
* @param month the Julian month-of-year, from 1 to 12
* @param dayOfMonth the Julian day-of-month, from 1 to 31
* @return the date in Julian calendar system, not null
* @throws DateTimeException if the value of any field is out of range,
* or if the day-of-year is invalid for the month-year
*/
static JulianDate create(int prolepticYear, int month, int dayOfMonth) {
JulianChronology.YEAR_RANGE.checkValidValue(prolepticYear, YEAR);
MONTH_OF_YEAR.checkValidValue(month);
DAY_OF_MONTH.checkValidValue(dayOfMonth);
if (dayOfMonth > 28) {
int dom = 31;
switch (month) {
case 2:
dom = (JulianChronology.INSTANCE.isLeapYear(prolepticYear) ? 29 : 28);
break;
case 4:
case 6:
case 9:
case 11:
dom = 30;
break;
default:
break;
}
if (dayOfMonth > dom) {
if (dayOfMonth == 29) {
throw new DateTimeException("Invalid date 'February 29' as '" + prolepticYear + "' is not a leap year");
} else {
throw new DateTimeException("Invalid date '" + Month.of(month).name() + " " + dayOfMonth + "'");
}
}
}
return new JulianDate(prolepticYear, month, dayOfMonth);
}
//-----------------------------------------------------------------------
/**
* Creates an instance from validated data.
*
* @param prolepticYear the Julian proleptic-year
* @param month the Julian month, from 1 to 12
* @param dayOfMonth the Julian day-of-month, from 1 to 31
*/
private JulianDate(int prolepticYear, int month, int dayOfMonth) {
this.prolepticYear = prolepticYear;
this.month = (short) month;
this.day = (short) dayOfMonth;
}
/**
* Validates the object.
*
* @return the resolved date, not null
*/
private Object readResolve() {
return JulianDate.create(prolepticYear, month, day);
}
//-----------------------------------------------------------------------
@Override
int getProlepticYear() {
return prolepticYear;
}
@Override
int getMonth() {
return month;
}
@Override
int getDayOfMonth() {
return day;
}
@Override
int getDayOfYear() {
return Month.of(month).firstDayOfYear(isLeapYear()) + day - 1;
}
@Override
ValueRange rangeAlignedWeekOfMonth() {
return ValueRange.of(1, month == 2 && isLeapYear() == false ? 4 : 5);
}
@Override
JulianDate resolvePrevious(int newYear, int newMonth, int dayOfMonth) {
return resolvePreviousValid(newYear, newMonth, dayOfMonth);
}
//-----------------------------------------------------------------------
/**
* Gets the chronology of this date, which is the Julian calendar system.
*
* The {@code Chronology} represents the calendar system in use.
* The era and other fields in {@link ChronoField} are defined by the chronology.
*
* @return the Julian chronology, not null
*/
@Override
public JulianChronology getChronology() {
return JulianChronology.INSTANCE;
}
/**
* Gets the era applicable at this date.
*
* The Julian calendar system has two eras, 'AD' and 'BC',
* defined by {@link JulianEra}.
*
* @return the era applicable at this date, not null
*/
@Override
public JulianEra getEra() {
return (prolepticYear >= 1 ? JulianEra.AD : JulianEra.BC);
}
/**
* Returns the length of the month represented by this date.
*
* This returns the length of the month in days.
* Month lengths match those of the ISO calendar system.
*
* @return the length of the month in days, from 28 to 31
*/
@Override
public int lengthOfMonth() {
switch (month) {
case 2:
return (isLeapYear() ? 29 : 28);
case 4:
case 6:
case 9:
case 11:
return 30;
default:
return 31;
}
}
//-------------------------------------------------------------------------
@Override
public JulianDate with(TemporalAdjuster adjuster) {
return (JulianDate) adjuster.adjustInto(this);
}
@Override
public JulianDate with(TemporalField field, long newValue) {
return (JulianDate) super.with(field, newValue);
}
//-----------------------------------------------------------------------
@Override
public JulianDate plus(TemporalAmount amount) {
return (JulianDate) amount.addTo(this);
}
@Override
public JulianDate plus(long amountToAdd, TemporalUnit unit) {
return (JulianDate) super.plus(amountToAdd, unit);
}
@Override
public JulianDate minus(TemporalAmount amount) {
return (JulianDate) amount.subtractFrom(this);
}
@Override
public JulianDate minus(long amountToSubtract, TemporalUnit unit) {
return (amountToSubtract == Long.MIN_VALUE ? plus(Long.MAX_VALUE, unit).plus(1, unit) : plus(-amountToSubtract, unit));
}
//-------------------------------------------------------------------------
@Override // for covariant return type
@SuppressWarnings("unchecked")
public ChronoLocalDateTime atTime(LocalTime localTime) {
return (ChronoLocalDateTime) super.atTime(localTime);
}
@Override
public long until(Temporal endExclusive, TemporalUnit unit) {
return super.until(JulianDate.from(endExclusive), unit);
}
@Override
public ChronoPeriod until(ChronoLocalDate endDateExclusive) {
return super.doUntil(JulianDate.from(endDateExclusive));
}
//-----------------------------------------------------------------------
@Override
public long toEpochDay() {
long year = (long) prolepticYear;
long julianEpochDay = ((year - 1) * 365) + Math.floorDiv((year - 1), 4) + (getDayOfYear() - 1);
return julianEpochDay - JULIAN_0001_TO_ISO_1970;
}
}