Century Class
- public class Century
extends Object
implements Cloneable
, Comparable
, Serializable
This class provides the Java biding for the XML schema type
year as specified in Section 3.3.29 of XML Schema Part 2:
Datatypes.
year represents a specific period of time that starts at the
midnight that starts of the first day of the year and ends at the
midnight that ends the last day of the year.
The value space of century is the set of Gregorian calendar
centuries specified as CC.
Example: 21
for 21st century
-
Hierarchy
-
Object
Century
-
All Implemented Interfaces
-
Cloneable
, Comparable
, Serializable
-
Direct Known Subclasses
-
Year
-
Century()
- Constructs a new Century instance.
|
-
Century(long century,
TimeZone timeZone)
- Constructs a new Century for the given century and timezone.
|
public Object |
-
clone ()
- Returns a copy of this Century.
|
public int |
-
compareTo (Century anotherCentury)
Compares this Century to another Century object (represented
in the same time zone) in their canonical representation.
|
public int |
-
compareTo (Object anotherObject)
- Compares this Century another object.
|
public static Century |
-
createCentury ()
- Returns a Century instance for the current century.
|
public static Century |
-
createCentury (String century)
Given a string of the form CC, returns a
Century instance.
|
public long |
-
getCentury ()
- Returns the year (CC) field
|
public int |
-
getEra ()
- Returns the era (+/-)
|
public TimeZone |
-
getTimeZone ()
- Returns the time zone
|
public void |
-
setCentury (long century)
- Sets the year (CCYY) field
|
public void |
-
setEra (int era)
- Sets the era (+/-)
|
public void |
-
setTimeZone (int zoneHour, int zoneMinute)
- Sets the time zone
|
public void |
-
setTimeZone (TimeZone timeZone)
- Sets the time zone
|
public String |
-
toString ()
Returns a XML schema compliant year string.
|
public Object |
-
toUTC ()
- Offsets the current century instant to UTC.
|
_internal
protected TimePeriod
_internal
Century
protected Century()
- Constructs a new Century instance.
Century
protected Century(long century,
TimeZone
timeZone)
- Constructs a new Century for the given century and timezone.
clone() Method
public Object
clone()
Returns a copy of this Century.
-
Overrides
-
Object.clone()
Returns
- copy
compareTo(Century) Method
public int compareTo(Century
anotherCentury)
Compares this Century to another Century object (represented
in the same time zone) in their canonical representation.
Parameters
-
anotherCentury
- another Century object to be compared.
Returns
- the value 0 if the argument Century is equal to
this Century; a value less than 0 if this Century is
before the Century argument; and a value greater than 0 if
this Century is after the Century argument.
compareTo(Object) Method
public int compareTo(Object
anotherObject)
Compares this Century another object. If the other object is a
Century, this method behaves like
compareTo(Century). Otherwise, it throws a ClassCastException.
Parameters
-
anotherObject
- the object to be compared
Returns
- the value 0 if the argument Century is equal to
this Century; a value less than 0 if this Century is
before the Century argument; and a value greater than 0 if
this Century is after the Century argument.
createCentury() Method
public static Century
createCentury()
Returns a Century instance for the current century.
Returns
- instance of Century
createCentury(String) Method
public static Century
createCentury(String
century)
throws ParseException
Given a string of the form CC, returns a
Century instance.
The argument may optionally include a timezone.
Returns
- instance of Century
Exceptions
-
ParseException
getCentury() Method
public long getCentury()
Returns the year (CC) field
Returns
- the year
getEra() Method
public int getEra()
Returns the era (+/-)
Returns
- the era (one of java.util.GregorianCalendar.AD or java.util.GregorianCalendar.BC)
getTimeZone() Method
public TimeZone
getTimeZone()
Returns the time zone
Returns
- timeZone the time zone
setCentury(long) Method
public void setCentury(long century)
throws IllegalArgumentException
Sets the year (CCYY) field
Parameters
-
century
- the century (CC)
Exceptions
-
IllegalArgumentException
- thrown when the century and
year arguments are illegal
setEra(int) Method
public void setEra(int era)
Sets the era (+/-)
Parameters
-
era
- the era (+/-)
setTimeZone(int, int) Method
public void setTimeZone(int zoneHour,
int zoneMinute)
Sets the time zone
Parameters
-
zoneHour
- the hour field of timeZone. Can be negative to
indicate negative offset.
-
zoneMinute
- the minute field of timeZone
setTimeZone(TimeZone) Method
public void setTimeZone(TimeZone
timeZone)
Sets the time zone
Parameters
-
timeZone
- an instance java.util.TimeZone
toString() Method
public String
toString()
Returns a XML schema compliant year string.
-
Overrides
-
Object.toString()
Returns
- string value
toUTC() Method
public Object
toUTC()
Offsets the current century instant to UTC.
Returns
- instance of Century offset to UTC