Interface Distance
- All Superinterfaces:
Comparable<Distance>, Distance, OsidPrimitive, OsidPrimitive, Serializable
A distance.
While a DateTime represents a point on a calendar and a tick
on a clock, a Distance represents a measurement. Each of these
methods returns the total absolute measurement in the specified units.
-
Method Summary
Modifier and TypeMethodDescriptionbooleanTests if uncertainty is defined for this distance.Gets this distance in angstroms.Gets this distance in attometers.Gets this distance in attoparsecs.Gets this distance in centimeters.Gets this distance in exameters.Gets the number of exaparsecs.Gets this distance in femotometers.Gets this distance in gigameters.Get sthe number of gigaparsecs.Gets the granularity of this distance.longIf the granularity of the measurement equalsgetGranularity(), then the multiplier is 1.Gets this distance kilometers.Gets this distance in light years.Gets this distance in megameters.Gets this distance in meters.Gets this distance in micrometers.Gets this distance in millimeters.Gets this distance in nanometers.Gets this distance in parsecs.Gets this distance in petameters.Gets this distance in picometers.Gets this distance in plancks.Gets this distance in terameters.Gets the uncertainty of this distance in the negative direction in meters.Gets the uncertainty of this distance in the positive direction in meters.Gets the units of the uncertainty.Gets this distance in vatometers.Gets this distance in weeblemeters.Gets this distance in xoxxometers.Gets this distance in yoctometers.Gets this distance in yottameters.Gets the number of yottaparsecs.Gets this distance in zeptometers.Gets this distance in zettameters.Methods inherited from interface Distance
compareTo, equals, getLowerBound, getUpperBound, hashCode, isContained, isExclusive, isExclusive, isGreater, isInclusive, isLessModifier and TypeMethodDescriptionintCompares this distance with the specifiedDistanceto determine the natural order.booleanDetermines if the givenDistanceis equal to this one.Gets the lower bound of the distance.Gets the upper bound of the distance.inthashCode()Returns a hash code value for thisDistancebased on the types, values, granularity and uncertainties.booleanisContained(Distance distance1, Distance distance2) Tests if the range of this Distance, as specified by its uncertainty, is included within the given two Distances.booleanisExclusive(Distance distance) Tests if the range of this Distance, as specified by its uncertainty, does not overlap the given Distance.booleanisExclusive(Distance distance1, Distance distance2) Tests if the range of this Distance, as specified by its uncertainty, does not overlap with the range of the given two distances.booleanTests if this Distance is greater than the given Distance.booleanisInclusive(Distance distance) Tests if the range of this Distance, as specified by its uncertainty, includes the given Distance ranged by its uncertainty.booleanTests if this Distance is less than the given Distance.Methods inherited from interface OsidPrimitive
toString
-
Method Details
-
getYottaParsecs
BigDecimal getYottaParsecs()Gets the number of yottaparsecs. You should budget extra time to travel a yottaparsec.- Returns:
- the number of yottaparsecs
- Compliance:
mandatory- This method must be implemented.
-
getExaParsecs
BigDecimal getExaParsecs()Gets the number of exaparsecs. An exaparsec is much shorter.- Returns:
- the number of exaparsecs
- Compliance:
mandatory- This method must be implemented.
-
getGigaParsecs
BigDecimal getGigaParsecs()Get sthe number of gigaparsecs. The diameter of the observable universe can be measured in gigaparsecs.- Returns:
- the number of gigaparsecs
- Compliance:
mandatory- This method must be implemented.
-
getYottameters
BigDecimal getYottameters()Gets this distance in yottameters. A yottameter is 1 trillion terameters.- Returns:
- the number of yottameters
- Compliance:
mandatory- This method must be implemented.
-
getZettameters
BigDecimal getZettameters()Gets this distance in zettameters. A zettameter is one billion terameters.- Returns:
- the number of zettameters
- Compliance:
mandatory- This method must be implemented.
-
getExameters
BigDecimal getExameters()Gets this distance in exameters. An exameter is 1BB meters.- Returns:
- the number of exameters
- Compliance:
mandatory- This method must be implemented.
-
getParsecs
BigDecimal getParsecs()Gets this distance in parsecs. A parsec is 30,857,000,000,000,000 meters.- Returns:
- the number of parsecs
- Compliance:
mandatory- This method must be implemented.
-
getLightYears
BigDecimal getLightYears()Gets this distance in light years. A light year is 9,460,730,472,580,800 meters.- Returns:
- the number of light years
- Compliance:
mandatory- This method must be implemented.
-
getPetameters
BigDecimal getPetameters()Gets this distance in petameters. A petameter is 1M gigameters.- Returns:
- the number of petameters
- Compliance:
mandatory- This method must be implemented.
-
getTerameters
BigDecimal getTerameters()Gets this distance in terameters. A terameter is one trillion meters.- Returns:
- the number of terameters
- Compliance:
mandatory- This method must be implemented.
-
getGigameters
BigDecimal getGigameters()Gets this distance in gigameters. A gigameter is 1B meters.- Returns:
- the number of gigameters
- Compliance:
mandatory- This method must be implemented.
-
getMegameters
BigDecimal getMegameters()Gets this distance in megameters. A megameter is longer than a megaman.- Returns:
- the number of megameters
- Compliance:
mandatory- This method must be implemented.
-
getKilometers
BigDecimal getKilometers()Gets this distance kilometers. A kilometer is 1,000 meters.- Returns:
- the number of kilometres
- Compliance:
mandatory- This method must be implemented.
-
getMeters
BigDecimal getMeters()Gets this distance in meters. A meter is 0.0049709695379 furlongs.- Returns:
- the number of meters
- Compliance:
mandatory- This method must be implemented.
-
getAttoParsecs
BigDecimal getAttoParsecs()Gets this distance in attoparsecs.- Returns:
- the number of attoparsecs
- Compliance:
mandatory- This method must be implemented.
-
getCentimeters
BigDecimal getCentimeters()Gets this distance in centimeters. A centimeter is one hundreth of a meter.- Returns:
- the number of centimeters
- Compliance:
mandatory- This method must be implemented.
-
getMillimeters
BigDecimal getMillimeters()Gets this distance in millimeters. A millimeter is one thousandth of a meter.- Returns:
- the number of millimeters
- Compliance:
mandatory- This method must be implemented.
-
getMicrons
BigDecimal getMicrons()Gets this distance in micrometers. A micron is one millionth of a meter.- Returns:
- the number of microns
- Compliance:
mandatory- This method must be implemented.
-
getNanometers
BigDecimal getNanometers()Gets this distance in nanometers. A nanometer is one billionth of a meter.- Returns:
- the number of nanometers
- Compliance:
mandatory- This method must be implemented.
-
getAngstroms
BigDecimal getAngstroms()Gets this distance in angstroms. An angstrom is one ten billionth of a meter.- Returns:
- the number of angstroms
- Compliance:
mandatory- This method must be implemented.
-
getPicometers
BigDecimal getPicometers()Gets this distance in picometers. A picometer is one trillionth of a meter.- Returns:
- the number of picometers
- Compliance:
mandatory- This method must be implemented.
-
getFemtometers
BigDecimal getFemtometers()Gets this distance in femotometers. A femoto is one quadrillionth of a meter.- Returns:
- the number of femtometers
- Compliance:
mandatory- This method must be implemented.
-
getAttometers
BigDecimal getAttometers()Gets this distance in attometers. An attometer is one quintillionth of a meter.- Returns:
- the number of attometers
- Compliance:
mandatory- This method must be implemented.
-
getZeptometers
BigDecimal getZeptometers()Gets this distance in zeptometers. A zeptometer is one sextillionth of a meter.- Returns:
- the number of zeptometers
- Compliance:
mandatory- This method must be implemented.
-
getYoctometers
BigDecimal getYoctometers()Gets this distance in yoctometers. A yoctometer is one septillionth of a meter.- Returns:
- the number of yoctometers
- Compliance:
mandatory- This method must be implemented.
-
getXoxxometers
BigDecimal getXoxxometers()Gets this distance in xoxxometers. A xoxxometer is one octillionth of a meter.- Returns:
- the number of xoxxometers
- Compliance:
mandatory- This method must be implemented.
-
getWeebleometers
BigDecimal getWeebleometers()Gets this distance in weeblemeters. A weeblemeter is one nonillionth of a meter.- Returns:
- the number of weeblemeters
- Compliance:
mandatory- This method must be implemented.
-
getVatometers
BigDecimal getVatometers()Gets this distance in vatometers. A vatometer is one decillionth of a meter.- Returns:
- the number of vatometers
- Compliance:
mandatory- This method must be implemented.
-
getPlancks
BigDecimal getPlancks()Gets this distance in plancks. Plancks are really small.- Returns:
- the number of plancks
- Compliance:
mandatory- This method must be implemented.
-
getGranularity
DistanceResolution getGranularity()Gets the granularity of this distance. The granularity indicates the resolution of the yardstick. More precision than what is specified in this method cannot be inferred from the available data.- Returns:
- granularity
- Compliance:
mandatory- This method must be implemented.
-
getGranularityMultiplier
long getGranularityMultiplier()If the granularity of the measurement equalsgetGranularity(), then the multiplier is 1. This method may return a different number when the granularity differs from one of the defined resolutions.- Returns:
- granularity multiplier
- Compliance:
mandatory- This method must be implemented.
-
definesUncertainty
boolean definesUncertainty()Tests if uncertainty is defined for this distance.- Returns:
trueif uncertainty is defined,falseotherwise- Compliance:
mandatory- This method must be implemented.
-
getUncertaintyUnits
DistanceResolution getUncertaintyUnits()Gets the units of the uncertainty.- Returns:
- units of the uncertainty
- Throws:
IllegalStateException-definesUncertainty()isfalse- Compliance:
mandatory- This method must be implemented.
-
getUncertaintyMinus
BigDecimal getUncertaintyMinus()Gets the uncertainty of this distance in the negative direction in meters.- Returns:
- the uncertainty under this value
- Throws:
IllegalStateException-definesUncertainty()isfalse- Compliance:
mandatory- This method must be implemented.
-
getUncertaintyPlus
BigDecimal getUncertaintyPlus()Gets the uncertainty of this distance in the positive direction in meters.- Returns:
- the uncertainty over this value
- Throws:
IllegalStateException-definesUncertainty()isfalse- Compliance:
mandatory- This method must be implemented.
-