sun.util.calendar

Class Era

java.lang.Object

sun.util.calendar.Era

public final class Era
extends java.lang.Object

The class Era represents a calendar era that defines a period of time in which the same year numbering is used. For example, Gregorian year 2004 is Heisei 16 in the Japanese calendar system. An era starts at any point of time (Gregorian) that is represented by CalendarDate.

Eras that are applicable to a particular calendar system can be obtained by calling CalendarSystem.getEras() one of which can be used to specify a date in CalendarDate.

The following era names are defined in this release.

   Calendar system         Era name         Since (in Gregorian)
   -----------------------------------------------------------------------
   Japanese calendar       Meiji            1868-01-01 midnight local time
                           Taisho           1912-07-30 midnight local time
                           Showa            1926-12-26 midnight local time
                           Heisei           1989-01-08 midnight local time
   Julian calendar         BeforeCommonEra  -292275055-05-16T16:47:04.192Z
                           CommonEra        0000-12-30 midnight local time
   Taiwanese calendar      MinGuo           1911-01-01 midnight local time
   Thai Buddhist calendar  BuddhistEra      -543-01-01 midnight local time
   -----------------------------------------------------------------------
 

Since:

1.5

Author:

Masayoshi Okutsu

Constructor Summary

Constructors

Constructor and Description
Era(java.lang.String name, java.lang.String abbr, long since, boolean localTime) Constructs an Era instance.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o)
java.lang.String	getAbbreviation()
java.lang.String	getDiaplayAbbreviation(java.util.Locale locale)
java.lang.String	getDisplayName(java.util.Locale locale)
java.lang.String	getName()
long	getSince(java.util.TimeZone zone)
CalendarDate	getSinceDate()
int	hashCode()
boolean	isLocalTime()
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Era

public Era(java.lang.String name,
   java.lang.String abbr,
   long since,
   boolean localTime)

Constructs an Era instance.

Parameters:

name - the era name (e.g., "BeforeCommonEra" for the Julian calendar system)

abbr - the abbreviation of the era name (e.g., "B.C.E." for "BeforeCommonEra")

since - the time (millisecond offset from January 1, 1970 (Gregorian) UTC or local time) when the era starts, inclusive.

localTime - true if since specifies a local time; false if since specifies UTC

Method Detail

getName

public java.lang.String getName()

getDisplayName

public java.lang.String getDisplayName(java.util.Locale locale)

getAbbreviation

public java.lang.String getAbbreviation()

getDiaplayAbbreviation

public java.lang.String getDiaplayAbbreviation(java.util.Locale locale)

getSince

public long getSince(java.util.TimeZone zone)

getSinceDate

public CalendarDate getSinceDate()

isLocalTime

public boolean isLocalTime()

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object