java.lang.Object | ||
↳ | org.joda.time.base.BaseSingleFieldPeriod | |
↳ | org.joda.time.Months |
An immutable time period representing a number of months.
Months
is an immutable period that can only store months.
It does not store years, days or hours for example. As such it is a
type-safe way of representing a number of months in an application.
The number of months is set in the constructor, and may be queried using
getMonths()
. Basic mathematical operations are provided -
plus()
, minus()
, multipliedBy()
and
dividedBy()
.
Months
is thread-safe and immutable.
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
EIGHT | Constant representing eight months. | ||||||||||
ELEVEN | Constant representing eleven months. | ||||||||||
FIVE | Constant representing five months. | ||||||||||
FOUR | Constant representing four months. | ||||||||||
MAX_VALUE | Constant representing the maximum number of months that can be stored in this object. | ||||||||||
MIN_VALUE | Constant representing the minimum number of months that can be stored in this object. | ||||||||||
NINE | Constant representing nine months. | ||||||||||
ONE | Constant representing one month. | ||||||||||
SEVEN | Constant representing seven months. | ||||||||||
SIX | Constant representing six months. | ||||||||||
TEN | Constant representing ten months. | ||||||||||
THREE | Constant representing three months. | ||||||||||
TWELVE | Constant representing twelve months. | ||||||||||
TWO | Constant representing two months. | ||||||||||
ZERO | Constant representing zero months. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Returns a new instance with the months divided by the specified divisor.
| |||||||||||
Gets the duration field type, which is
months . | |||||||||||
Gets the number of months that this period represents.
| |||||||||||
Gets the period type, which is
months . | |||||||||||
Is this months instance greater than the specified number of months.
| |||||||||||
Is this months instance less than the specified number of months.
| |||||||||||
Returns a new instance with the specified number of months taken away.
| |||||||||||
Returns a new instance with the specified number of months taken away.
| |||||||||||
Obtains an instance of
Months that may be cached. | |||||||||||
Creates a
Months representing the number of whole months
between the two specified partial datetimes. | |||||||||||
Creates a
Months representing the number of whole months
between the two specified datetimes. | |||||||||||
Creates a
Months representing the number of whole months
in the specified interval. | |||||||||||
Returns a new instance with the months multiplied by the specified scalar.
| |||||||||||
Returns a new instance with the months value negated.
| |||||||||||
Creates a new
Months by parsing a string in the ISO8601 format 'PnM'. | |||||||||||
Returns a new instance with the specified number of months added.
| |||||||||||
Returns a new instance with the specified number of months added.
| |||||||||||
Gets this instance as a String in the ISO8601 duration format.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.joda.time.base.BaseSingleFieldPeriod
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
java.lang.Comparable
| |||||||||||
From interface
org.joda.time.ReadablePeriod
|
Constant representing the maximum number of months that can be stored in this object.
Constant representing the minimum number of months that can be stored in this object.
Returns a new instance with the months divided by the specified divisor. The calculation uses integer division, thus 3 divided by 2 is 1.
This instance is immutable and unaffected by this method call.
divisor | the amount to divide by, may be negative |
---|
ArithmeticException | if the divisor is zero |
---|
Gets the duration field type, which is months
.
Gets the number of months that this period represents.
Is this months instance greater than the specified number of months.
other | the other period, null means zero |
---|
Is this months instance less than the specified number of months.
other | the other period, null means zero |
---|
Returns a new instance with the specified number of months taken away.
This instance is immutable and unaffected by this method call.
months | the amount of months to take away, may be negative, null means zero |
---|
ArithmeticException | if the result overflows an int |
---|
Returns a new instance with the specified number of months taken away.
This instance is immutable and unaffected by this method call.
months | the amount of months to take away, may be negative |
---|
ArithmeticException | if the result overflows an int |
---|
Obtains an instance of Months
that may be cached.
Months
is immutable, so instances can be cached and shared.
This factory method provides access to shared instances.
months | the number of months to obtain an instance for |
---|
Creates a Months
representing the number of whole months
between the two specified partial datetimes.
The two partials must contain the same fields, for example you can specify
two LocalDate
objects.
start | the start partial date, must not be null |
---|---|
end | the end partial date, must not be null |
IllegalArgumentException | if the partials are null or invalid |
---|
Creates a Months
representing the number of whole months
between the two specified datetimes. This method corectly handles
any daylight savings time changes that may occur during the interval.
start | the start instant, must not be null |
---|---|
end | the end instant, must not be null |
IllegalArgumentException | if the instants are null or invalid |
---|
Creates a Months
representing the number of whole months
in the specified interval. This method corectly handles any daylight
savings time changes that may occur during the interval.
interval | the interval to extract months from, null returns zero |
---|
IllegalArgumentException | if the partials are null or invalid |
---|
Returns a new instance with the months multiplied by the specified scalar.
This instance is immutable and unaffected by this method call.
scalar | the amount to multiply by, may be negative |
---|
ArithmeticException | if the result overflows an int |
---|
Returns a new instance with the months value negated.
ArithmeticException | if the result overflows an int |
---|
Creates a new Months
by parsing a string in the ISO8601 format 'PnM'.
The parse will accept the full ISO syntax of PnYnMnWnDTnHnMnS however only the months component may be non-zero. If any other component is non-zero, an exception will be thrown.
periodStr | the period string, null returns zero |
---|
IllegalArgumentException | if the string format is invalid |
---|
Returns a new instance with the specified number of months added.
This instance is immutable and unaffected by this method call.
months | the amount of months to add, may be negative, null means zero |
---|
ArithmeticException | if the result overflows an int |
---|
Returns a new instance with the specified number of months added.
This instance is immutable and unaffected by this method call.
months | the amount of months to add, may be negative |
---|
ArithmeticException | if the result overflows an int |
---|
Gets this instance as a String in the ISO8601 duration format.
For example, "P4M" represents 4 months.