java.lang.Object | ||
↳ | org.joda.time.base.BaseSingleFieldPeriod | |
↳ | org.joda.time.Years |
An immutable time period representing a number of years.
Years
is an immutable period that can only store years.
It does not store years, days or hours for example. As such it is a
type-safe way of representing a number of years in an application.
The number of years is set in the constructor, and may be queried using
getYears()
. Basic mathematical operations are provided -
plus()
, minus()
, multipliedBy()
and
dividedBy()
.
Years
is thread-safe and immutable.
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
MAX_VALUE | Constant representing the maximum number of years that can be stored in this object. | ||||||||||
MIN_VALUE | Constant representing the minimum number of years that can be stored in this object. | ||||||||||
ONE | Constant representing one year. | ||||||||||
THREE | Constant representing three years. | ||||||||||
TWO | Constant representing two years. | ||||||||||
ZERO | Constant representing zero years. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Returns a new instance with the years divided by the specified divisor.
| |||||||||||
Gets the duration field type, which is
years . | |||||||||||
Gets the period type, which is
years . | |||||||||||
Gets the number of years that this period represents.
| |||||||||||
Is this years instance greater than the specified number of years.
| |||||||||||
Is this years instance less than the specified number of years.
| |||||||||||
Returns a new instance with the specified number of years taken away.
| |||||||||||
Returns a new instance with the specified number of years taken away.
| |||||||||||
Returns a new instance with the years multiplied by the specified scalar.
| |||||||||||
Returns a new instance with the years value negated.
| |||||||||||
Creates a new
Years by parsing a string in the ISO8601 format 'PnY'. | |||||||||||
Returns a new instance with the specified number of years added.
| |||||||||||
Returns a new instance with the specified number of years added.
| |||||||||||
Gets this instance as a String in the ISO8601 duration format.
| |||||||||||
Obtains an instance of
Years that may be cached. | |||||||||||
Creates a
Years representing the number of whole years
between the two specified datetimes. | |||||||||||
Creates a
Years representing the number of whole years
between the two specified partial datetimes. | |||||||||||
Creates a
Years representing the number of whole years
in the specified interval. |
[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 years that can be stored in this object.
Constant representing the minimum number of years that can be stored in this object.
Returns a new instance with the years 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 years
.
Gets the number of years that this period represents.
Is this years instance greater than the specified number of years.
other | the other period, null means zero |
---|
Is this years instance less than the specified number of years.
other | the other period, null means zero |
---|
Returns a new instance with the specified number of years taken away.
This instance is immutable and unaffected by this method call.
years | the amount of years 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 years taken away.
This instance is immutable and unaffected by this method call.
years | the amount of years to take away, may be negative |
---|
ArithmeticException | if the result overflows an int |
---|
Returns a new instance with the years 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 years value negated.
ArithmeticException | if the result overflows an int |
---|
Creates a new Years
by parsing a string in the ISO8601 format 'PnY'.
The parse will accept the full ISO syntax of PnYnMnWnDTnHnMnS however only the years 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 years added.
This instance is immutable and unaffected by this method call.
years | the amount of years to add, may be negative, null means zero |
---|
ArithmeticException | if the result overflows an int |
---|
Returns a new instance with the specified number of years added.
This instance is immutable and unaffected by this method call.
years | the amount of years 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, "P4Y" represents 4 years.
Obtains an instance of Years
that may be cached.
Years
is immutable, so instances can be cached and shared.
This factory method provides access to shared instances.
years | the number of years to obtain an instance for |
---|
Creates a Years
representing the number of whole years
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 Years
representing the number of whole years
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 Years
representing the number of whole years
in the specified interval. This method corectly handles any daylight
savings time changes that may occur during the interval.
interval | the interval to extract years from, null returns zero |
---|
IllegalArgumentException | if the partials are null or invalid |
---|