/** * Gets the number of years that this period represents. * * @return the number of years in the period */ public int getYears() { return getValue(); }
/** * Is this years instance less than the specified number of years. * * @param other the other period, null means zero * @return true if this years instance is less than the specified one */ public boolean isLessThan(Years other) { if (other == null) { return getValue() < 0; } return getValue() < other.getValue(); }
/** * Is this years instance greater than the specified number of years. * * @param other the other period, null means zero * @return true if this years instance is greater than the specified one */ public boolean isGreaterThan(Years other) { if (other == null) { return getValue() > 0; } return getValue() > other.getValue(); }
/** * Is this years instance greater than the specified number of years. * * @param other the other period, null means zero * @return true if this years instance is greater than the specified one */ public boolean isGreaterThan(Years other) { if (other == null) { return getValue() > 0; } return getValue() > other.getValue(); }
/** * Is this years instance less than the specified number of years. * * @param other the other period, null means zero * @return true if this years instance is less than the specified one */ public boolean isLessThan(Years other) { if (other == null) { return getValue() < 0; } return getValue() < other.getValue(); }
/** * Gets the number of years that this period represents. * * @return the number of years in the period */ public int getYears() { return getValue(); }
/** * Resolves singletons. * * @return the singleton instance */ private Object readResolve() { return Years.years(getValue()); }
/** * Gets this instance as a String in the ISO8601 duration format. * <p> * For example, "P4Y" represents 4 years. * * @return the value as an ISO8601 string */ @ToString public String toString() { return "P" + String.valueOf(getValue()) + "Y"; }
/** * Gets this instance as a String in the ISO8601 duration format. * <p> * For example, "P4Y" represents 4 years. * * @return the value as an ISO8601 string */ @ToString public String toString() { return "P" + String.valueOf(getValue()) + "Y"; }
/** * Resolves singletons. * * @return the singleton instance */ private Object readResolve() { return Years.years(getValue()); }
/** * Returns a new instance with the specified number of years added. * <p> * This instance is immutable and unaffected by this method call. * * @param years the amount of years to add, may be negative, null means zero * @return the new period plus the specified number of years * @throws ArithmeticException if the result overflows an int */ public Years plus(Years years) { if (years == null) { return this; } return plus(years.getValue()); }
/** * Returns a new instance with the specified number of years taken away. * <p> * This instance is immutable and unaffected by this method call. * * @param years the amount of years to take away, may be negative, null means zero * @return the new period minus the specified number of years * @throws ArithmeticException if the result overflows an int */ public Years minus(Years years) { if (years == null) { return this; } return minus(years.getValue()); }
/** * Returns a new instance with the years divided by the specified divisor. * The calculation uses integer division, thus 3 divided by 2 is 1. * <p> * This instance is immutable and unaffected by this method call. * * @param divisor the amount to divide by, may be negative * @return the new period divided by the specified divisor * @throws ArithmeticException if the divisor is zero */ public Years dividedBy(int divisor) { if (divisor == 1) { return this; } return Years.years(getValue() / divisor); }
/** * Returns a new instance with the specified number of years taken away. * <p> * This instance is immutable and unaffected by this method call. * * @param years the amount of years to take away, may be negative, null means zero * @return the new period minus the specified number of years * @throws ArithmeticException if the result overflows an int */ public Years minus(Years years) { if (years == null) { return this; } return minus(years.getValue()); }
/** * Returns a new instance with the years value negated. * * @return the new period with a negated value * @throws ArithmeticException if the result overflows an int */ public Years negated() { return Years.years(FieldUtils.safeNegate(getValue())); }
/** * Returns a new instance with the years multiplied by the specified scalar. * <p> * This instance is immutable and unaffected by this method call. * * @param scalar the amount to multiply by, may be negative * @return the new period multiplied by the specified scalar * @throws ArithmeticException if the result overflows an int */ public Years multipliedBy(int scalar) { return Years.years(FieldUtils.safeMultiply(getValue(), scalar)); }
/** * Returns a new instance with the years multiplied by the specified scalar. * <p> * This instance is immutable and unaffected by this method call. * * @param scalar the amount to multiply by, may be negative * @return the new period multiplied by the specified scalar * @throws ArithmeticException if the result overflows an int */ public Years multipliedBy(int scalar) { return Years.years(FieldUtils.safeMultiply(getValue(), scalar)); }
/** * Returns a new instance with the years value negated. * * @return the new period with a negated value * @throws ArithmeticException if the result overflows an int */ public Years negated() { return Years.years(FieldUtils.safeNegate(getValue())); }
/** * Returns a new instance with the specified number of years added. * <p> * This instance is immutable and unaffected by this method call. * * @param years the amount of years to add, may be negative * @return the new period plus the specified number of years * @throws ArithmeticException if the result overflows an int */ public Years plus(int years) { if (years == 0) { return this; } return Years.years(FieldUtils.safeAdd(getValue(), years)); }
/** * Returns a new instance with the specified number of years added. * <p> * This instance is immutable and unaffected by this method call. * * @param years the amount of years to add, may be negative * @return the new period plus the specified number of years * @throws ArithmeticException if the result overflows an int */ public Years plus(int years) { if (years == 0) { return this; } return Years.years(FieldUtils.safeAdd(getValue(), years)); }