|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.joda.time.base.AbstractPeriod
public abstract class AbstractPeriod
AbstractPeriod provides the common behaviour for period classes.
This class should generally not be used directly by API users. The
ReadablePeriod interface should be used when different
kinds of periods are to be referenced.
AbstractPeriod subclasses may be mutable and not thread-safe.
| Constructor Summary | |
|---|---|
protected |
AbstractPeriod()
Constructor. |
| Method Summary | |
|---|---|
boolean |
equals(Object period)
Compares this object with the specified object for equality based on the value of each field. |
int |
get(DurationFieldType type)
Gets the value of one of the fields. |
DurationFieldType |
getFieldType(int index)
Gets the field type at the specified index. |
DurationFieldType[] |
getFieldTypes()
Gets an array of the field types that this period supports. |
int[] |
getValues()
Gets an array of the value of each of the fields that this period supports. |
int |
hashCode()
Gets a hash code for the period as defined by ReadablePeriod. |
int |
indexOf(DurationFieldType type)
Gets the index of the field in this period. |
boolean |
isSupported(DurationFieldType type)
Checks whether the field specified is supported by this period. |
int |
size()
Gets the number of fields that this period supports. |
MutablePeriod |
toMutablePeriod()
Get this object as a MutablePeriod. |
Period |
toPeriod()
Get this period as an immutable Period object. |
String |
toString()
Gets the value as a String in the ISO8601 duration format. |
String |
toString(PeriodFormatter formatter)
Uses the specified formatter to convert this period to a String. |
| Methods inherited from class java.lang.Object |
|---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| Methods inherited from interface org.joda.time.ReadablePeriod |
|---|
getPeriodType, getValue |
| Constructor Detail |
|---|
protected AbstractPeriod()
| Method Detail |
|---|
public int size()
size in interface ReadablePeriodpublic DurationFieldType getFieldType(int index)
getFieldType in interface ReadablePeriodindex - the index to retrieve
IndexOutOfBoundsException - if the index is invalidpublic DurationFieldType[] getFieldTypes()
The fields are returned largest to smallest, for example Hours, Minutes, Seconds.
public int[] getValues()
The fields are returned largest to smallest, for example Hours, Minutes, Seconds.
Each value corresponds to the same array index as getFields()
public int get(DurationFieldType type)
If the field type specified is not supported by the period then zero is returned.
get in interface ReadablePeriodtype - the field type to query, null returns zero
public boolean isSupported(DurationFieldType type)
isSupported in interface ReadablePeriodtype - the type to check, may be null which returns false
public int indexOf(DurationFieldType type)
type - the type to check, may be null which returns -1
public Period toPeriod()
Period object.
toPeriod in interface ReadablePeriodpublic MutablePeriod toMutablePeriod()
MutablePeriod.
This will always return a new MutablePeriod with the same fields.
toMutablePeriod in interface ReadablePeriodpublic boolean equals(Object period)
Note that a period of 1 day is not equal to a period of 24 hours, nor is 1 hour equal to 60 minutes. Only periods with the same amount in each field are equal.
This is because periods represent an abstracted definition of a time period (eg. a day may not actually be 24 hours, it might be 23 or 25 at daylight savings boundary).
To compare the actual duration of two periods, convert both to
Durations, an operation that emphasises
that the result may differ according to the date you choose.
equals in interface ReadablePeriodequals in class Objectperiod - a readable period to check against
public int hashCode()
hashCode in interface ReadablePeriodhashCode in class Objectpublic String toString()
For example, "P6H3M7S" represents 6 hours, 3 minutes, 7 seconds.
For more control over the output, see
PeriodFormatterBuilder.
toString in interface ReadablePeriodtoString in class Objectpublic String toString(PeriodFormatter formatter)
formatter - the formatter to use, null means use toString().
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||