Packages

  • package root
    Definition Classes
    root
  • package org
    Definition Classes
    root
  • package threeten
    Definition Classes
    org
  • package bp

    The main API for dates, times, instants, and durations.

    The main API for dates, times, instants, and durations.

    The classes defined here represent the principal date-time concepts, including instants, durations, dates, times, time-zones and periods. They are based on the ISO calendar system, which is the de facto world calendar following the proleptic Gregorian rules. All the classes are immutable and thread-safe.

    Each date time instance is composed of fields that are conveniently made available by the APIs. For lower level access to the fields refer to the org.threeten.bp.temporal package. Each class includes support for printing and parsing all manner of dates and times. Refer to the org.threeten.bp.format package for customization options.

    The org.threeten.bp.chrono package contains the calendar neutral API. This is intended for use by applications that need to use localized calendars. It is recommended that applications use the ISO-8601 dates and time classes from this package across system boundaries, such as to the database or across the network. The calendar neutral API should be reserved for interactions with users.

    Dates and Times

    org.threeten.bp.Instant is essentially a numeric timestamp. The current Instant can be retrieved from a org.threeten.bp.Clock. This is useful for logging and persistence of a point in time and has in the past been associated with storing the result from java.lang.System#currentTimeMillis().

    org.threeten.bp.LocalDate stores a date without a time. This stores a date like '2010-12-03' and could be used to store a birthday.

    org.threeten.bp.LocalTime stores a time without a date. This stores a time like '11:30' and could be used to store an opening or closing time.

    org.threeten.bp.LocalDateTime stores a date and time. This stores a date-time like '2010-12-03T11:30'.

    org.threeten.bp.OffsetTime stores a time and offset from UTC without a date. This stores a date like '11:30+01:00'. The ZoneOffset is of the form '+01:00'.

    org.threeten.bp.OffsetDateTime stores a date and time and offset from UTC. This stores a date-time like '2010-12-03T11:30+01:00'. This is sometimes found in XML messages and other forms of persistence, but contains less information than a full time-zone.

    org.threeten.bp.ZonedDateTime stores a date and time with a time-zone. This is useful if you want to perform accurate calculations of dates and times taking into account the org.threeten.bp.ZoneId, such as 'Europe/Paris'. Where possible, it is recommended to use a simpler class. The widespread use of time-zones tends to add considerable complexity to an application.

    Duration and Period

    Beyond dates and times, the API also allows the storage of period and durations of time. A org.threeten.bp.Duration is a simple measure of time along the time-line in nanoseconds. A org.threeten.bp.Period expresses an amount of time in units meaningful to humans, such as years or hours.

    Additional value types

    org.threeten.bp.Year stores a year on its own. This stores a single year in isolation, such as '2010'.

    org.threeten.bp.YearMonth stores a year and month without a day or time. This stores a year and month, such as '2010-12' and could be used for a credit card expiry.

    org.threeten.bp.MonthDay stores a month and day without a year or time. This stores a month and day-of-month, such as '--12-03' and could be used to store an annual event like a birthday without storing the year.

    org.threeten.bp.Month stores a month on its own. This stores a single month-of-year in isolation, such as 'DECEMBER'.

    org.threeten.bp.DayOfWeek stores a day-of-week on its own. This stores a single day-of-week in isolation, such as 'TUESDAY'.

    Definition Classes
    threeten
  • package chrono

    Support for calendar systems other than the default ISO.

    Support for calendar systems other than the default ISO.

    The main API is based around the calendar system defined in ISO-8601. This package provides support for alternate systems.

    The supported calendar systems includes:

    -Hijrah calendar -Japanese calendar -Minguo calendar -Thai Buddhist calendar

    It is intended that applications use the main API whenever possible, including code to read and write from a persistent data store, such as a database, and to send dates and times across a network. This package is then used at the user interface level to deal with localized input/output. See ChronoLocalDate for a full discussion of the issues.

    Example

    This example creates and uses a date in a non-ISO calendar system.

            // Print the Thai Buddhist date
            ChronoLocalDate now1 = ThaiBuddhistChronology.INSTANCE.now();
            int day = now1.get(ChronoField.DAY_OF_MONTH);
            int dow = now1.get(ChronoField.DAY_OF_WEEK);
            int month = now1.get(ChronoField.MONTH_OF_YEAR);
            int year = now1.get(ChronoField.YEAR);
            System.out.printf("  Today is %s %s %d-%s-%d%n", now1.getChronology().getId(),
                    dow, day, month, year);
    
            // Enumerate the list of available calendars and print today for each
            Set<String> names = Chronology.getAvailableIds();
            for (String name : names) {
                Chronology<?> chrono = Chronology.of(name);
                ChronoLocalDate<?> date = chrono.now();
                System.out.printf("   %20s: %s%n", chrono.getId(), date.toString());
            }
    
            // Print today's date and the last day of the year for the Thai Buddhist Calendar.
            ChronoLocalDate first = now1
                    .with(ChronoField.DAY_OF_MONTH, 1)
                    .with(ChronoField.MONTH_OF_YEAR, 1);
            ChronoLocalDate last = first
                    .plus(1, ChronoUnit.YEARS)
                    .minus(1, ChronoUnit.DAYS);
            System.out.printf("  %s: 1st of year: %s; end of year: %s%n", last.getChronology().getId(),
                    first, last);
    

    Definition Classes
    bp
  • package internal
    Definition Classes
    chrono
  • AbstractChronology
  • ChronoDateImpl
  • ChronoLocalDate
  • ChronoLocalDateTime
  • ChronoLocalDateTimeImpl
  • ChronoPeriod
  • ChronoPeriodImpl
  • ChronoZonedDateTime
  • ChronoZonedDateTimeImpl
  • Chronology
  • Era
  • HijrahChronology
  • HijrahDate
  • HijrahDateConfigurator
  • HijrahEra
  • IsoChronology
  • IsoEra
  • JapaneseChronology
  • JapaneseDate
  • JapaneseEra
  • MinguoChronology
  • MinguoDate
  • MinguoEra
  • Ser
  • ThaiBuddhistChronology
  • ThaiBuddhistDate
  • ThaiBuddhistEra

final class JapaneseChronology extends Chronology with Serializable

The Japanese Imperial calendar system.

This chronology defines the rules of the Japanese Imperial calendar system. This calendar system is primarily used in Japan. The Japanese Imperial calendar system is the same as the ISO calendar system apart from the era-based year numbering.

Japan introduced the Gregorian calendar starting with Meiji 6. Only Meiji and later eras are supported; dates before Meiji 6, January 1 are not supported.

The supported ChronoField instances are:

  • DAY_OF_WEEK
  • DAY_OF_MONTH
  • DAY_OF_YEAR
  • EPOCH_DAY
  • MONTH_OF_YEAR
  • PROLEPTIC_MONTH
  • YEAR_OF_ERA
  • YEAR
  • ERA
Specification for implementors

This class is immutable and thread-safe.

Annotations
@SerialVersionUID()
Linear Supertypes
Serializable, Chronology, Ordered[Chronology], Comparable[Chronology], AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. JapaneseChronology
  2. Serializable
  3. Chronology
  4. Ordered
  5. Comparable
  6. AnyRef
  7. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. def <(that: Chronology): Boolean
    Definition Classes
    Ordered
  4. def <=(that: Chronology): Boolean
    Definition Classes
    Ordered
  5. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  6. def >(that: Chronology): Boolean
    Definition Classes
    Ordered
  7. def >=(that: Chronology): Boolean
    Definition Classes
    Ordered
  8. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  9. def clone(): AnyRef
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  10. def compare(other: Chronology): Int

    Compares this chronology to another chronology.

    Compares this chronology to another chronology.

    The comparison order first by the chronology ID string, then by any additional information specific to the subclass. It is "consistent with equals", as defined by Comparable.

    The default implementation compares the chronology ID. Subclasses must compare any additional state that they store.

    other

    the other chronology to compare to, not null

    returns

    the comparator value, negative if less, positive if greater

    Definition Classes
    Chronology → Ordered
  11. def compareTo(that: Chronology): Int
    Definition Classes
    Ordered → Comparable
  12. def date(temporal: TemporalAccessor): JapaneseDate

    Obtains a local date in this chronology from another temporal object.

    Obtains a local date in this chronology from another temporal object.

    This creates a date in this chronology based on the specified TemporalAccessor.

    The standard mechanism for conversion between date types is the local epoch-day field.

    temporal

    the temporal object to convert, not null

    returns

    the local date in this chronology, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if unable to create the date

  13. def date(prolepticYear: Int, month: Int, dayOfMonth: Int): JapaneseDate

    Obtains a local date in this chronology from the proleptic-year, month-of-year and day-of-month fields.

    Obtains a local date in this chronology from the proleptic-year, month-of-year and day-of-month fields.

    prolepticYear

    the chronology proleptic-year

    month

    the chronology month-of-year

    dayOfMonth

    the chronology day-of-month

    returns

    the local date in this chronology, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if unable to create the date

  14. def date(era: Era, yearOfEra: Int, month: Int, dayOfMonth: Int): JapaneseDate

    Obtains a local date in this chronology from the era, year-of-era, month-of-year and day-of-month fields.

    Obtains a local date in this chronology from the era, year-of-era, month-of-year and day-of-month fields.

    era

    the era of the correct type for the chronology, not null

    yearOfEra

    the chronology year-of-era

    month

    the chronology month-of-year

    dayOfMonth

    the chronology day-of-month

    returns

    the local date in this chronology, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    ClassCastException if the { @code era} is not of the correct type for the chronology

    DateTimeException if unable to create the date

  15. def dateEpochDay(epochDay: Long): JapaneseDate

    Obtains a local date in this chronology from the epoch-day.

    Obtains a local date in this chronology from the epoch-day.

    The definition of EPOCH_DAY is the same for all calendar systems, thus it can be used for conversion.

    epochDay

    the epoch day

    returns

    the local date in this chronology, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if unable to create the date

  16. def dateNow(clock: Clock): JapaneseDate

    Obtains the current local date in this chronology from the specified clock.

    Obtains the current local date in this chronology 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 null

    returns

    the current local date, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if unable to create the date

  17. def dateNow(zone: ZoneId): JapaneseDate

    Obtains the current local date in this chronology from the system clock in the specified time-zone.

    Obtains the current local date in this chronology 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 null

    returns

    the current local date using the system clock, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if unable to create the date

  18. def dateNow: JapaneseDate

    Obtains the current local date in this chronology from the system clock in the default time-zone.

    Obtains the current local date in this chronology 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.

    This implementation uses #dateNow(Clock).

    returns

    the current local date using the system clock and default time-zone, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if unable to create the date

  19. def dateYearDay(prolepticYear: Int, dayOfYear: Int): JapaneseDate

    Obtains a local date in Japanese calendar system from the proleptic-year and day-of-year fields.

    Obtains a local date in Japanese calendar system from the proleptic-year and day-of-year fields.

    The day-of-year in this factory is expressed relative to the start of the proleptic year. The Japanese proleptic year and day-of-year are the same as those in the ISO calendar system. They are not reset when the era changes.

    prolepticYear

    the proleptic-year

    dayOfYear

    the day-of-year

    returns

    the Japanese local date, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if unable to create the date

  20. def dateYearDay(era: Era, yearOfEra: Int, dayOfYear: Int): JapaneseDate

    Obtains a local date in Japanese calendar system from the era, year-of-era and day-of-year fields.

    Obtains a local date in Japanese calendar system from the era, year-of-era and day-of-year fields.

    The day-of-year in this factory is expressed relative to the start of the year-of-era. This definition changes the normal meaning of day-of-year only in those years where the year-of-era is reset to one due to a change in the era. For example:

    6th Jan Showa 64 = day-of-year 6
    7th Jan Showa 64 = day-of-year 7
    8th Jan Heisei 1 = day-of-year 1
    9th Jan Heisei 1 = day-of-year 2
    

    era

    the Japanese era, not null

    yearOfEra

    the year-of-era

    dayOfYear

    the day-of-year

    returns

    the Japanese local date, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    ClassCastException if the { @code era} is not a { @code JapaneseEra}

    DateTimeException if unable to create the date

  21. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  22. def equals(obj: Any): Boolean

    Checks if this chronology is equal to another chronology.

    Checks if this chronology is equal to another chronology.

    The comparison is based on the entire state of the object.

    The default implementation checks the type and calls #compareTo(Chronology).

    obj

    the object to check, null returns false

    returns

    true if this is equal to the other chronology

    Definition Classes
    Chronology → AnyRef → Any
  23. def eraOf(eraValue: Int): JapaneseEra

    Returns the calendar system era object from the given numeric value.

    Returns the calendar system era object from the given numeric value.

    See the description of each Era for the numeric values of: JapaneseEra#HEISEI, JapaneseEra#SHOWA,JapaneseEra#TAISHO, JapaneseEra#MEIJI), only Meiji and later eras are supported.

    eraValue

    the era value

    returns

    the Japanese { @code Era} for the given numeric era value

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if { @code eraValue} is invalid

  24. def eras: List[Era]

    Gets the list of eras for the chronology.

    Gets the list of eras for the chronology.

    Most calendar systems have an era, within which the year has meaning. If the calendar system does not support the concept of eras, an empty list must be returned.

    returns

    the list of eras for the chronology, may be immutable, not null

    Definition Classes
    JapaneseChronologyChronology
  25. def finalize(): Unit
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  26. def getCalendarType: String

    Gets the calendar type of the underlying calendar system - 'japanese'.

    Gets the calendar type of the underlying calendar system - 'japanese'.

    The calendar type is an identifier defined by the Unicode Locale Data Markup Language (LDML) specification. It can be used to lookup the Chronology using #of(String). It can also be used as part of a locale, accessible via Locale#getUnicodeLocaleType(String) with the key 'ca'.

    returns

    the calendar system type - 'japanese'

    Definition Classes
    JapaneseChronologyChronology
    See also

    #getId()

  27. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
  28. def getDisplayName(style: TextStyle, locale: Locale): String

    Gets the textual representation of this chronology.

    Gets the textual representation of this chronology.

    This returns the textual name used to identify the chronology. The parameters control the style of the returned text and the locale.

    style

    the style of the text required, not null

    locale

    the locale to use, not null

    returns

    the text value of the chronology, not null

    Definition Classes
    Chronology
  29. def getId: String

    Gets the ID of the chronology - 'Japanese'.

    Gets the ID of the chronology - 'Japanese'.

    The ID uniquely identifies the Chronology. It can be used to lookup the Chronology using #of(String).

    returns

    the chronology ID - 'Japanese'

    Definition Classes
    JapaneseChronologyChronology
    See also

    #getCalendarType()

  30. def hashCode(): Int

    A hash code for this chronology.

    A hash code for this chronology.

    The default implementation is based on the ID and class. Subclasses should add any additional state that they store.

    returns

    a suitable hash code

    Definition Classes
    Chronology → AnyRef → Any
  31. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  32. def isLeapYear(prolepticYear: Long): Boolean

    Checks if the specified year is a leap year.

    Checks if the specified year is a leap year.

    Japanese calendar leap years occur exactly in line with ISO leap years. This method does not validate the year passed in, and only has a well-defined result for years in the supported range.

    prolepticYear

    the proleptic-year to check, not validated for range

    returns

    true if the year is a leap year

    Definition Classes
    JapaneseChronologyChronology
  33. def localDateTime(temporal: TemporalAccessor): ChronoLocalDateTime[JapaneseDate]

    Obtains a local date-time in this chronology from another temporal object.

    Obtains a local date-time in this chronology from another temporal object.

    This creates a date-time in this chronology based on the specified TemporalAccessor.

    The date of the date-time should be equivalent to that obtained by calling #date(TemporalAccessor). The standard mechanism for conversion between time types is the nano-of-day field.

    temporal

    the temporal object to convert, not null

    returns

    the local date-time in this chronology, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if unable to create the date-time

  34. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  35. final def notify(): Unit
    Definition Classes
    AnyRef
  36. final def notifyAll(): Unit
    Definition Classes
    AnyRef
  37. def period(years: Int, months: Int, days: Int): ChronoPeriod

    Obtains a period for this chronology based on years, months and days.

    Obtains a period for this chronology based on years, months and days.

    This returns a period tied to this chronology using the specified years, months and days. All supplied chronologies use periods based on years, months and days, however the ChronoPeriod API allows the period to be represented using other units.

    The default implementation returns an implementation class suitable for most calendar systems. It is based solely on the three units. Normalization, addition and subtraction derive the number of months in a year from the #range(ChronoField). If the number of months within a year is fixed, then the calculation approach for addition, subtraction and normalization is slightly different.

    If implementing an unusual calendar system that is not based on years, months and days, or where you want direct control, then the ChronoPeriod interface must be directly implemented.

    The returned period is immutable and thread-safe.

    years

    the number of years, may be negative

    months

    the number of years, may be negative

    days

    the number of years, may be negative

    returns

    the period in terms of this chronology, not null

    Definition Classes
    Chronology
  38. def prolepticYear(era: Era, yearOfEra: Int): Int

    Calculates the proleptic-year given the era and year-of-era.

    Calculates the proleptic-year given the era and year-of-era.

    This combines the era and year-of-era into the single proleptic-year field.

    era

    the era of the correct type for the chronology, not null

    yearOfEra

    the chronology year-of-era

    returns

    the proleptic-year

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    ClassCastException if the { @code era} is not of the correct type for the chronology

    DateTimeException if unable to convert

  39. def range(field: ChronoField): ValueRange

    Gets the range of valid values for the specified field.

    Gets the range of valid values for the specified field.

    All fields can be expressed as a long integer. This method returns an object that describes the valid range for that value.

    Note that the result only describes the minimum and maximum valid values and it is important not to read too much into them. For example, there could be values within the range that are invalid for the field.

    This method will return a result whether or not the chronology supports the field.

    field

    the field to get the range for, not null

    returns

    the range of valid values for the field, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if the range for the field cannot be obtained

  40. def resolveDate(fieldValues: Map[TemporalField, Long], resolverStyle: ResolverStyle): JapaneseDate

    Resolves parsed ChronoField values into a date during parsing.

    Resolves parsed ChronoField values into a date during parsing.

    Most TemporalField implementations are resolved using the resolve method on the field. By contrast, the ChronoField class defines fields that only have meaning relative to the chronology. As such, ChronoField date fields are resolved here in the context of a specific chronology.

    The default implementation, which explains typical resolve behaviour, is provided in AbstractChronology.

    fieldValues

    the map of fields to values, which can be updated, not null

    resolverStyle

    the requested type of resolve, not null

    returns

    the resolved date, null if insufficient information to create a date

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if the date cannot be resolved, typically because of a conflict in the input data

  41. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  42. def toString(): String

    Outputs this chronology as a String, using the ID.

    Outputs this chronology as a String, using the ID.

    returns

    a string representation of this chronology, not null

    Definition Classes
    Chronology → AnyRef → Any
  43. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  44. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  45. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  46. def zonedDateTime(instant: Instant, zone: ZoneId): ChronoZonedDateTime[JapaneseDate]

    Obtains a zoned date-time in this chronology from an Instant.

    Obtains a zoned date-time in this chronology from an Instant.

    This creates a zoned date-time with the same instant as that specified.

    instant

    the instant to create the date-time from, not null

    zone

    the time-zone, not null

    returns

    the zoned date-time, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if the result exceeds the supported range

  47. def zonedDateTime(temporal: TemporalAccessor): ChronoZonedDateTime[JapaneseDate]

    Obtains a zoned date-time in this chronology from another temporal object.

    Obtains a zoned date-time in this chronology from another temporal object.

    This creates a date-time in this chronology based on the specified TemporalAccessor.

    This should obtain a ZoneId using ZoneId#from(TemporalAccessor). The date-time should be obtained by obtaining an Instant. If that fails, the local date-time should be used.

    temporal

    the temporal object to convert, not null

    returns

    the zoned date-time in this chronology, not null

    Definition Classes
    JapaneseChronologyChronology
    Exceptions thrown

    DateTimeException if unable to create the date-time

Inherited from Serializable

Inherited from Chronology

Inherited from Ordered[Chronology]

Inherited from Comparable[Chronology]

Inherited from AnyRef

Inherited from Any

Ungrouped