public final class Symmetry454Date extends Object implements ChronoLocalDate, Serializable
This date operates using the Symmetry454 calendar.
This calendar system is a proposed reform calendar system, and is not in common use.
The Symmetry454 calendar differs from the Gregorian in terms of month length, and the leap year rule.
Dates are aligned such that 0001/01/01 (Sym454) is 0001-01-01 (ISO).
The alignment of January 1st happens 40 times within a 293 years cycle, skipping 5, 6, 11 or 12 years in between:
1, 7, 18, 24, 29, 35, 46, 52, 57, 63, 74, 80, 85, 91, 103, 114, 120, 125, 131, 142,
148, 153, 159, 170, 176, 181, 187, 198, 210, 216, 221, 227, 238, 244, 249, 255, 266, 272, 277, 283.
The implementation is a pure Symmetry454 calendar, as proposed by Dr. Irv Bromberg. The year shares the 12 months with the Gregorian calendar. The months February, May, August, November span 35 days, all other months consist of 28 days. In leap years, December is extended with a full week, the so-called "leap week". Since each month is made of full weeks, the calendar is perennial, with every date fixed always on the same weekday. Each month starts on a Monday and ends on a Sunday; so does each year. The 13th day of a month is always a Saturday.
More information is available on Wikipedia at Symmetry454 or on the calendar's home page.
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 ==.
| Modifier and Type | Method and Description |
|---|---|
ChronoLocalDateTime<Symmetry454Date> |
atTime(LocalTime localTime) |
boolean |
equals(Object obj)
Compares this date to another date, including the chronology.
|
static Symmetry454Date |
from(TemporalAccessor temporal)
Obtains a
Symmetry454Date from a temporal object. |
Symmetry454Chronology |
getChronology()
Gets the chronology of this date, which is the Symmetry454 calendar system.
|
IsoEra |
getEra()
Gets the era applicable at this date.
|
long |
getLong(TemporalField field) |
int |
hashCode()
A hash code for this date.
|
boolean |
isLeapWeek()
Checks if the date is within the leap week.
|
int |
lengthOfMonth()
Returns the length of the month represented by this date.
|
int |
lengthOfYear()
Returns the length of the year represented by this date.
|
Symmetry454Date |
minus(long amountToSubtract,
TemporalUnit unit) |
Symmetry454Date |
minus(TemporalAmount amount) |
static Symmetry454Date |
now()
Obtains the current
Symmetry454Date from the system clock in the default time-zone. |
static Symmetry454Date |
now(Clock clock)
Obtains the current
Symmetry454Date from the specified clock. |
static Symmetry454Date |
now(ZoneId zone)
Obtains the current
Symmetry454Date from the system clock in the specified time-zone. |
static Symmetry454Date |
of(int prolepticYear,
int month,
int dayOfMonth)
Obtains a
Symmetry454Date representing a date in the Symmetry454 calendar
system from the proleptic-year, month-of-year and day-of-month fields. |
Symmetry454Date |
plus(long amountToAdd,
TemporalUnit unit) |
Symmetry454Date |
plus(TemporalAmount amount) |
ValueRange |
range(TemporalField field) |
long |
toEpochDay() |
String |
toString()
Display the date in human-readable format.
|
ChronoPeriod |
until(ChronoLocalDate endDateExclusive) |
long |
until(Temporal endExclusive,
TemporalUnit unit) |
Symmetry454Date |
with(TemporalAdjuster adjuster) |
Symmetry454Date |
with(TemporalField field,
long newValue) |
clone, finalize, getClass, notify, notifyAll, wait, wait, waitadjustInto, compareTo, equals, format, hashCode, isAfter, isBefore, isEqual, isLeapYear, isSupported, isSupported, query, timeLineOrderget, getLongpublic static Symmetry454Date now()
Symmetry454Date from the system clock in the default time-zone.
This will query the 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.
public static Symmetry454Date now(ZoneId zone)
Symmetry454Date from the system clock in the specified time-zone.
This will query the 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.
zone - the zone ID to use, not nullpublic static Symmetry454Date now(Clock clock)
Symmetry454Date 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 dependency injection.
clock - the clock to use, not nullDateTimeException - if the current date cannot be obtainedpublic static Symmetry454Date of(int prolepticYear, int month, int dayOfMonth)
Symmetry454Date representing a date in the Symmetry454 calendar
system from the proleptic-year, month-of-year and day-of-month fields.
This returns a Symmetry454Date with the specified fields.
The day must be valid for the year and month, otherwise an exception will be thrown.
prolepticYear - the Symmetry454 proleptic-yearmonth - the Symmetry454 month-of-year, from 1 to 12dayOfMonth - the Symmetry454 day-of-month, from 1 to 28, or 1 to 35 in February, May, August, November
and December in a Leap YearDateTimeException - if the value of any field is out of range,
or if the day-of-month is invalid for the month-yearpublic static Symmetry454Date from(TemporalAccessor temporal)
Symmetry454Date from a temporal object.
This obtains a date in the Symmetry454 calendar system based on the specified temporal.
A TemporalAccessor represents an arbitrary set of date and time information,
which this factory converts to an instance of Symmetry454Date.
The conversion typically uses the EPOCH_DAY
field, which is standardized across calendar systems.
This method matches the signature of the functional interface TemporalQuery
allowing it to be used as a query via method reference, Symmetry454Date::from.
from in interface ChronoLocalDatetemporal - the temporal object to convert, not nullDateTimeException - if unable to convert to a Symmetry454Datepublic boolean isLeapWeek()
public ValueRange range(TemporalField field)
range in interface TemporalAccessorpublic Symmetry454Chronology getChronology()
The Chronology represents the calendar system in use.
The era and other fields in ChronoField are defined by the chronology.
getChronology in interface ChronoLocalDatepublic IsoEra getEra()
The Symmetry454 calendar system uses IsoEra.
getEra in interface ChronoLocalDatepublic int lengthOfMonth()
This returns the length of the month in days. Month lengths do not match those of the ISO calendar system.
Most months have 28 days, except for February, May, August, November, and December in a leap year, each has 35 days.
lengthOfMonth in interface ChronoLocalDatepublic int lengthOfYear()
This returns the length of the year in days. Year lengths do NOT match those of the ISO calendar system.
lengthOfYear in interface ChronoLocalDatepublic Symmetry454Date with(TemporalAdjuster adjuster)
with in interface ChronoLocalDatewith in interface Temporalpublic Symmetry454Date with(TemporalField field, long newValue)
with in interface ChronoLocalDatewith in interface Temporalpublic Symmetry454Date plus(TemporalAmount amount)
plus in interface ChronoLocalDateplus in interface Temporalpublic Symmetry454Date plus(long amountToAdd, TemporalUnit unit)
plus in interface ChronoLocalDateplus in interface Temporalpublic Symmetry454Date minus(TemporalAmount amount)
minus in interface ChronoLocalDateminus in interface Temporalpublic Symmetry454Date minus(long amountToSubtract, TemporalUnit unit)
minus in interface ChronoLocalDateminus in interface Temporalpublic ChronoLocalDateTime<Symmetry454Date> atTime(LocalTime localTime)
atTime in interface ChronoLocalDatepublic long until(Temporal endExclusive, TemporalUnit unit)
until in interface ChronoLocalDateuntil in interface Temporalpublic ChronoPeriod until(ChronoLocalDate endDateExclusive)
until in interface ChronoLocalDatepublic long toEpochDay()
toEpochDay in interface ChronoLocalDatepublic String toString()
toString in interface ChronoLocalDatepublic long getLong(TemporalField field)
getLong in interface TemporalAccessorpublic boolean equals(Object obj)
Compares this date with another ensuring that the date is the same.
Only objects of this concrete type are compared, other types return false.
To compare the dates of two TemporalAccessor instances, including dates
in two different chronologies, use ChronoField.EPOCH_DAY as a comparator.
equals in interface ChronoLocalDateequals in class Objectobj - the object to check, null returns falsepublic int hashCode()
hashCode in interface ChronoLocalDatehashCode in class ObjectCopyright © 2010–2017 ThreeTen.org. All rights reserved.