- * The ISO-8601 standard does not define eras.
- * A definition has therefore been created with two eras - 'Current era' (CE) for
- * years from 0001-01-01 (ISO) and 'Before current era' (BCE) for years before that.
- *
{
-
- /**
- * The singleton instance for the era BCE, 'Before Current Era'.
- * The 'ISO' part of the name emphasizes that this differs from the BCE
- * era in the Gregorian calendar system.
- * This has the numeric value of {@code 0}.
- */
- BCE,
- /**
- * The singleton instance for the era CE, 'Current Era'.
- * The 'ISO' part of the name emphasizes that this differs from the CE
- * era in the Gregorian calendar system.
- * This has the numeric value of {@code 1}.
- */
- CE;
-
- //-----------------------------------------------------------------------
- /**
- * Obtains an instance of {@code ISOEra} from an {@code int} value.
- *
- * {@code ISOEra} is an enum representing the ISO eras of BCE/CE.
- * This factory allows the enum to be obtained from the {@code int} value.
- *
- * @param era the BCE/CE value to represent, from 0 (BCE) to 1 (CE)
- * @return the era singleton, not null
- * @throws DateTimeException if the value is invalid
- */
- public static ISOEra of(int era) {
- switch (era) {
- case 0:
- return BCE;
- case 1:
- return CE;
- default:
- throw new DateTimeException("Invalid era: " + era);
- }
- }
-
- //-----------------------------------------------------------------------
- /**
- * Gets the numeric era {@code int} value.
- *
- * The era BCE has the value 0, while the era CE has the value 1.
- *
- * @return the era value, from 0 (BCE) to 1 (CE)
- */
- @Override
- public int getValue() {
- return ordinal();
- }
-
- @Override
- public ISOChrono getChrono() {
- return ISOChrono.INSTANCE;
- }
-
- // JDK8 default methods:
- //-----------------------------------------------------------------------
- @Override
- public ChronoLocalDate date(int year, int month, int day) {
- return getChrono().date(this, year, month, day);
- }
-
- @Override
- public ChronoLocalDate dateYearDay(int year, int dayOfYear) {
- return getChrono().dateYearDay(this, year, dayOfYear);
- }
-
- //-----------------------------------------------------------------------
- @Override
- public boolean isSupported(TemporalField field) {
- if (field instanceof ChronoField) {
- return field == ERA;
- }
- return field != null && field.doIsSupported(this);
- }
-
- @Override
- public ValueRange range(TemporalField field) {
- if (field == ERA) {
- return field.range();
- } else if (field instanceof ChronoField) {
- throw new DateTimeException("Unsupported field: " + field.getName());
- }
- return field.doRange(this);
- }
-
- @Override
- public int get(TemporalField field) {
- if (field == ERA) {
- return getValue();
- }
- return range(field).checkValidIntValue(getLong(field), field);
- }
-
- @Override
- public long getLong(TemporalField field) {
- if (field == ERA) {
- return getValue();
- } else if (field instanceof ChronoField) {
- throw new DateTimeException("Unsupported field: " + field.getName());
- }
- return field.doGet(this);
- }
-
- //-------------------------------------------------------------------------
- @Override
- public Temporal adjustInto(Temporal temporal) {
- return temporal.with(ERA, getValue());
- }
-
- //-----------------------------------------------------------------------
- @Override
- public String getText(TextStyle style, Locale locale) {
- return new DateTimeFormatterBuilder().appendText(ERA, style).toFormatter(locale).print(this);
- }
-
-}