org.jfree.data.time
Class Quarter
- Comparable, MonthConstants, Serializable, TimePeriod
Defines a quarter (in a given year). The range supported is Q1 1900 to
Q4 9999. This class is immutable, which is a requirement for all
RegularTimePeriod
subclasses.
Quarter() - Constructs a new Quarter, based on the current system date/time.
|
Quarter(Date time) - Constructs a new Quarter, based on a date/time and the default time zone.
|
Quarter(Date time, TimeZone zone) - Constructs a Quarter, based on a date/time and time zone.
|
Quarter(int quarter, int year) - Constructs a new quarter.
|
Quarter(int quarter, Year year) - Constructs a new quarter.
|
int | compareTo(Object o1) - Returns an integer indicating the order of this Quarter object relative
to the specified object:
negative == before, zero == same, positive == after.
|
boolean | equals(Object obj) - Tests the equality of this Quarter object to an arbitrary object.
|
long | getFirstMillisecond() - Returns the first millisecond of the quarter.
|
long | getFirstMillisecond(Calendar calendar) - Returns the first millisecond in the Quarter, evaluated using the
supplied calendar (which determines the time zone).
|
long | getLastMillisecond() - Returns the last millisecond of the quarter.
|
long | getLastMillisecond(Calendar calendar) - Returns the last millisecond of the Quarter, evaluated using the
supplied calendar (which determines the time zone).
|
int | getQuarter() - Returns the quarter.
|
long | getSerialIndex() - Returns a serial index number for the quarter.
|
Year | getYear() - Returns the year.
|
int | getYearValue() - Returns the year.
|
int | hashCode() - Returns a hash code for this object instance.
|
RegularTimePeriod | next() - Returns the quarter following this one.
|
static Quarter | parseQuarter(String s) - Parses the string argument as a quarter.
|
void | peg(Calendar calendar) - Recalculates the start date/time and end date/time for this time period
relative to the supplied calendar (which incorporates a time zone).
|
RegularTimePeriod | previous() - Returns the quarter preceding this one.
|
String | toString() - Returns a string representing the quarter (e.g.
|
createInstance , downsize , getEnd , getFirstMillisecond , getFirstMillisecond , getFirstMillisecond , getLastMillisecond , getLastMillisecond , getLastMillisecond , getMiddleMillisecond , getMiddleMillisecond , getMiddleMillisecond , getSerialIndex , getStart , next , peg , previous , toString |
FIRST_QUARTER
public static final int FIRST_QUARTER
Constant for quarter 1.
LAST_QUARTER
public static final int LAST_QUARTER
Constant for quarter 4.
Quarter
public Quarter()
Constructs a new Quarter, based on the current system date/time.
Quarter
public Quarter(Date time)
Constructs a new Quarter, based on a date/time and the default time zone.
Quarter
public Quarter(Date time,
TimeZone zone)
Constructs a Quarter, based on a date/time and time zone.
time
- the date/time.zone
- the zone (null
not permitted).
Quarter
public Quarter(int quarter,
int year)
Constructs a new quarter.
quarter
- the quarter (1 to 4).year
- the year (1900 to 9999).
Quarter
public Quarter(int quarter,
Year year)
Constructs a new quarter.
quarter
- the quarter (1 to 4).year
- the year (1900 to 9999).
compareTo
public int compareTo(Object o1)
Returns an integer indicating the order of this Quarter object relative
to the specified object:
negative == before, zero == same, positive == after.
o1
- the object to compare
- negative == before, zero == same, positive == after.
equals
public boolean equals(Object obj)
Tests the equality of this Quarter object to an arbitrary object.
Returns true
if the target is a Quarter instance
representing the same quarter as this object. In all other cases,
returns false
.
obj
- the object (null
permitted).
true
if quarter and year of this and the object are
the same.
getFirstMillisecond
public long getFirstMillisecond()
Returns the first millisecond of the quarter. This will be determined
relative to the time zone specified in the constructor, or in the
calendar instance passed in the most recent call to the
peg(Calendar)
method.
- getFirstMillisecond in interface RegularTimePeriod
- The first millisecond of the quarter.
getFirstMillisecond
public long getFirstMillisecond(Calendar calendar)
Returns the first millisecond in the Quarter, evaluated using the
supplied calendar (which determines the time zone).
- getFirstMillisecond in interface RegularTimePeriod
calendar
- the calendar (null
not permitted).
- The first millisecond in the Quarter.
getLastMillisecond
public long getLastMillisecond()
Returns the last millisecond of the quarter. This will be
determined relative to the time zone specified in the constructor, or
in the calendar instance passed in the most recent call to the
peg(Calendar)
method.
- getLastMillisecond in interface RegularTimePeriod
- The last millisecond of the quarter.
getLastMillisecond
public long getLastMillisecond(Calendar calendar)
Returns the last millisecond of the Quarter, evaluated using the
supplied calendar (which determines the time zone).
- getLastMillisecond in interface RegularTimePeriod
calendar
- the calendar (null
not permitted).
- The last millisecond of the Quarter.
getQuarter
public int getQuarter()
Returns the quarter.
hashCode
public int hashCode()
Returns a hash code for this object instance. The approach described by
Joshua Bloch in "Effective Java" has been used here:
http://developer.java.sun.com/developer/Books/effectivejava
/Chapter3.pdf
parseQuarter
public static Quarter parseQuarter(String s)
Parses the string argument as a quarter.
This method should accept the following formats: "YYYY-QN" and "QN-YYYY",
where the "-" can be a space, a forward-slash (/), comma or a dash (-).
s
- A string representing the quarter.
peg
public void peg(Calendar calendar)
Recalculates the start date/time and end date/time for this time period
relative to the supplied calendar (which incorporates a time zone).
- peg in interface RegularTimePeriod
calendar
- the calendar (null
not permitted).
toString
public String toString()
Returns a string representing the quarter (e.g. "Q1/2002").
- toString in interface RegularTimePeriod
- A string representing the quarter.