MeasureUnit

See also:

• Measure

ACRE

public static final MeasureUnit ACRE

Constant for unit of area: acre

ACRE_FOOT

public static final MeasureUnit ACRE_FOOT

Constant for unit of volume: acre-foot

AMPERE

public static final MeasureUnit AMPERE

Constant for unit of electric: ampere

ARC_MINUTE

public static final MeasureUnit ARC_MINUTE

Constant for unit of angle: arc-minute

ARC_SECOND

public static final MeasureUnit ARC_SECOND

Constant for unit of angle: arc-second

ASTRONOMICAL_UNIT

public static final MeasureUnit ASTRONOMICAL_UNIT

Constant for unit of length: astronomical-unit

ATMOSPHERE

public static final MeasureUnit ATMOSPHERE

Constant for unit of pressure: atmosphere

BEAUFORT

public static final MeasureUnit BEAUFORT

Constant for unit of speed: beaufort

BIT

public static final MeasureUnit BIT

Constant for unit of digital: bit

BUSHEL

public static final MeasureUnit BUSHEL

Constant for unit of volume: bushel

BYTE

public static final MeasureUnit BYTE

Constant for unit of digital: byte

CALORIE

public static final MeasureUnit CALORIE

Constant for unit of energy: calorie

CANDELA

public static final MeasureUnit CANDELA

Constant for unit of light: candela

CARAT

public static final MeasureUnit CARAT

Constant for unit of mass: carat

CELSIUS

public static final MeasureUnit CELSIUS

Constant for unit of temperature: celsius

CENTILITER

public static final MeasureUnit CENTILITER

Constant for unit of volume: centiliter

CENTIMETER

public static final MeasureUnit CENTIMETER

Constant for unit of length: centimeter

CENTURY

public static final MeasureUnit CENTURY

Constant for unit of duration: century

CUBIC_CENTIMETER

public static final MeasureUnit CUBIC_CENTIMETER

Constant for unit of volume: cubic-centimeter

CUBIC_FOOT

public static final MeasureUnit CUBIC_FOOT

Constant for unit of volume: cubic-foot

CUBIC_INCH

public static final MeasureUnit CUBIC_INCH

Constant for unit of volume: cubic-inch

CUBIC_KILOMETER

public static final MeasureUnit CUBIC_KILOMETER

Constant for unit of volume: cubic-kilometer

CUBIC_METER

public static final MeasureUnit CUBIC_METER

Constant for unit of volume: cubic-meter

CUBIC_MILE

public static final MeasureUnit CUBIC_MILE

Constant for unit of volume: cubic-mile

CUBIC_YARD

public static final MeasureUnit CUBIC_YARD

Constant for unit of volume: cubic-yard

CUP

public static final MeasureUnit CUP

Constant for unit of volume: cup

CUP_METRIC

public static final MeasureUnit CUP_METRIC

Constant for unit of volume: cup-metric

DAY

public static final TimeUnit DAY

Constant for unit of duration: day

DECADE

public static final MeasureUnit DECADE

Constant for unit of duration: decade

DECILITER

public static final MeasureUnit DECILITER

Constant for unit of volume: deciliter

DECIMETER

public static final MeasureUnit DECIMETER

Constant for unit of length: decimeter

DEGREE

public static final MeasureUnit DEGREE

Constant for unit of angle: degree

DOT

public static final MeasureUnit DOT

Constant for unit of graphics: dot

DOT_PER_CENTIMETER

public static final MeasureUnit DOT_PER_CENTIMETER

Constant for unit of graphics: dot-per-centimeter

DOT_PER_INCH

public static final MeasureUnit DOT_PER_INCH

Constant for unit of graphics: dot-per-inch

EM

public static final MeasureUnit EM

Constant for unit of graphics: em

FAHRENHEIT

public static final MeasureUnit FAHRENHEIT

Constant for unit of temperature: fahrenheit

FATHOM

public static final MeasureUnit FATHOM

Constant for unit of length: fathom

FLUID_OUNCE

public static final MeasureUnit FLUID_OUNCE

Constant for unit of volume: fluid-ounce

FOODCALORIE

public static final MeasureUnit FOODCALORIE

Constant for unit of energy: foodcalorie

FOOT

public static final MeasureUnit FOOT

Constant for unit of length: foot

FURLONG

public static final MeasureUnit FURLONG

Constant for unit of length: furlong

GALLON

public static final MeasureUnit GALLON

Constant for unit of volume: gallon

GALLON_IMPERIAL

public static final MeasureUnit GALLON_IMPERIAL

Constant for unit of volume: gallon-imperial

GASOLINE_ENERGY_DENSITY

public static final MeasureUnit GASOLINE_ENERGY_DENSITY

Constant for unit of pressure: gasoline-energy-density

GENERIC_TEMPERATURE

public static final MeasureUnit GENERIC_TEMPERATURE

Constant for unit of temperature: generic

GIGABIT

public static final MeasureUnit GIGABIT

Constant for unit of digital: gigabit

GIGABYTE

public static final MeasureUnit GIGABYTE

Constant for unit of digital: gigabyte

GIGAHERTZ

public static final MeasureUnit GIGAHERTZ

Constant for unit of frequency: gigahertz

GIGAWATT

public static final MeasureUnit GIGAWATT

Constant for unit of power: gigawatt

GRAM

public static final MeasureUnit GRAM

Constant for unit of mass: gram

G_FORCE

public static final MeasureUnit G_FORCE

Constant for unit of acceleration: g-force

HECTARE

public static final MeasureUnit HECTARE

Constant for unit of area: hectare

HECTOLITER

public static final MeasureUnit HECTOLITER

Constant for unit of volume: hectoliter

HECTOPASCAL

public static final MeasureUnit HECTOPASCAL

Constant for unit of pressure: hectopascal

HERTZ

public static final MeasureUnit HERTZ

Constant for unit of frequency: hertz

HORSEPOWER

public static final MeasureUnit HORSEPOWER

Constant for unit of power: horsepower

HOUR

public static final TimeUnit HOUR

Constant for unit of duration: hour

INCH

public static final MeasureUnit INCH

Constant for unit of length: inch

INCH_HG

public static final MeasureUnit INCH_HG

Constant for unit of pressure: inch-ofhg

ITEM

public static final MeasureUnit ITEM

Constant for unit of concentr: item

JOULE

public static final MeasureUnit JOULE

Constant for unit of energy: joule

KARAT

public static final MeasureUnit KARAT

Constant for unit of concentr: karat

KELVIN

public static final MeasureUnit KELVIN

Constant for unit of temperature: kelvin

KILOBIT

public static final MeasureUnit KILOBIT

Constant for unit of digital: kilobit

KILOBYTE

public static final MeasureUnit KILOBYTE

Constant for unit of digital: kilobyte

KILOCALORIE

public static final MeasureUnit KILOCALORIE

Constant for unit of energy: kilocalorie

KILOGRAM

public static final MeasureUnit KILOGRAM

Constant for unit of mass: kilogram

KILOHERTZ

public static final MeasureUnit KILOHERTZ

Constant for unit of frequency: kilohertz

KILOJOULE

public static final MeasureUnit KILOJOULE

Constant for unit of energy: kilojoule

KILOMETER

public static final MeasureUnit KILOMETER

Constant for unit of length: kilometer

KILOMETER_PER_HOUR

public static final MeasureUnit KILOMETER_PER_HOUR

Constant for unit of speed: kilometer-per-hour

KILOWATT

public static final MeasureUnit KILOWATT

Constant for unit of power: kilowatt

KILOWATT_HOUR

public static final MeasureUnit KILOWATT_HOUR

Constant for unit of energy: kilowatt-hour

KILOWATT_HOUR_PER_100_KILOMETER

public static final MeasureUnit KILOWATT_HOUR_PER_100_KILOMETER

Constant for unit of force: kilowatt-hour-per-100-kilometer

KNOT

public static final MeasureUnit KNOT

Constant for unit of speed: knot

LIGHT_YEAR

public static final MeasureUnit LIGHT_YEAR

Constant for unit of length: light-year

LITER

public static final MeasureUnit LITER

Constant for unit of volume: liter

LITER_PER_100KILOMETERS

public static final MeasureUnit LITER_PER_100KILOMETERS

Constant for unit of consumption: liter-per-100-kilometer

LITER_PER_KILOMETER

public static final MeasureUnit LITER_PER_KILOMETER

Constant for unit of consumption: liter-per-kilometer

LUMEN

public static final MeasureUnit LUMEN

Constant for unit of light: lumen

LUX

public static final MeasureUnit LUX

Constant for unit of light: lux

MEGABIT

public static final MeasureUnit MEGABIT

Constant for unit of digital: megabit

MEGABYTE

public static final MeasureUnit MEGABYTE

Constant for unit of digital: megabyte

MEGAHERTZ

public static final MeasureUnit MEGAHERTZ

Constant for unit of frequency: megahertz

MEGALITER

public static final MeasureUnit MEGALITER

Constant for unit of volume: megaliter

MEGAPIXEL

public static final MeasureUnit MEGAPIXEL

Constant for unit of graphics: megapixel

MEGAWATT

public static final MeasureUnit MEGAWATT

Constant for unit of power: megawatt

METER

public static final MeasureUnit METER

Constant for unit of length: meter

METER_PER_SECOND

public static final MeasureUnit METER_PER_SECOND

Constant for unit of speed: meter-per-second

METER_PER_SECOND_SQUARED

public static final MeasureUnit METER_PER_SECOND_SQUARED

Constant for unit of acceleration: meter-per-square-second

METRIC_TON

public static final MeasureUnit METRIC_TON

Constant for unit of mass: metric-ton (renamed to tonne in CLDR 42 / ICU 72). Note: In ICU 74 this will be deprecated in favor of TONNE, which is currently draft but will become stable in ICU 74, and which uses the preferred naming.

MICROGRAM

public static final MeasureUnit MICROGRAM

Constant for unit of mass: microgram

MICROMETER

public static final MeasureUnit MICROMETER

Constant for unit of length: micrometer

MICROSECOND

public static final MeasureUnit MICROSECOND

Constant for unit of duration: microsecond

MILE

public static final MeasureUnit MILE

Constant for unit of length: mile

MILE_PER_GALLON

public static final MeasureUnit MILE_PER_GALLON

Constant for unit of consumption: mile-per-gallon

MILE_PER_GALLON_IMPERIAL

public static final MeasureUnit MILE_PER_GALLON_IMPERIAL

Constant for unit of consumption: mile-per-gallon-imperial

MILE_PER_HOUR

public static final MeasureUnit MILE_PER_HOUR

Constant for unit of speed: mile-per-hour

MILE_SCANDINAVIAN

public static final MeasureUnit MILE_SCANDINAVIAN

Constant for unit of length: mile-scandinavian

MILLIAMPERE

public static final MeasureUnit MILLIAMPERE

Constant for unit of electric: milliampere

MILLIBAR

public static final MeasureUnit MILLIBAR

Constant for unit of pressure: millibar

MILLIGRAM

public static final MeasureUnit MILLIGRAM

Constant for unit of mass: milligram

MILLIGRAM_OFGLUCOSE_PER_DECILITER

public static final MeasureUnit MILLIGRAM_OFGLUCOSE_PER_DECILITER

Constant for unit of concentr: milligram-ofglucose-per-deciliter

MILLIGRAM_PER_DECILITER

public static final MeasureUnit MILLIGRAM_PER_DECILITER

Constant for unit of concentr: milligram-per-deciliter

MILLILITER

public static final MeasureUnit MILLILITER

Constant for unit of volume: milliliter

MILLIMETER

public static final MeasureUnit MILLIMETER

Constant for unit of length: millimeter

MILLIMETER_OF_MERCURY

public static final MeasureUnit MILLIMETER_OF_MERCURY

Constant for unit of pressure: millimeter-ofhg

MILLIMOLE_PER_LITER

public static final MeasureUnit MILLIMOLE_PER_LITER

Constant for unit of concentr: millimole-per-liter

MILLISECOND

public static final MeasureUnit MILLISECOND

Constant for unit of duration: millisecond

MILLIWATT

public static final MeasureUnit MILLIWATT

Constant for unit of power: milliwatt

MINUTE

public static final TimeUnit MINUTE

Constant for unit of duration: minute

MONTH

public static final TimeUnit MONTH

Constant for unit of duration: month

NANOMETER

public static final MeasureUnit NANOMETER

Constant for unit of length: nanometer

NANOSECOND

public static final MeasureUnit NANOSECOND

Constant for unit of duration: nanosecond

NAUTICAL_MILE

public static final MeasureUnit NAUTICAL_MILE

Constant for unit of length: nautical-mile

OHM

public static final MeasureUnit OHM

Constant for unit of electric: ohm

OUNCE

public static final MeasureUnit OUNCE

Constant for unit of mass: ounce

OUNCE_TROY

public static final MeasureUnit OUNCE_TROY

Constant for unit of mass: ounce-troy

PARSEC

public static final MeasureUnit PARSEC

Constant for unit of length: parsec

PART_PER_MILLION

public static final MeasureUnit PART_PER_MILLION

Constant for unit of concentr: permillion

PERCENT

public static final MeasureUnit PERCENT

Constant for unit of concentr: percent

PERMILLE

public static final MeasureUnit PERMILLE

Constant for unit of concentr: permille

PETABYTE

public static final MeasureUnit PETABYTE

Constant for unit of digital: petabyte

PICOMETER

public static final MeasureUnit PICOMETER

Constant for unit of length: picometer

PINT

public static final MeasureUnit PINT

Constant for unit of volume: pint

PINT_METRIC

public static final MeasureUnit PINT_METRIC

Constant for unit of volume: pint-metric

PIXEL

public static final MeasureUnit PIXEL

Constant for unit of graphics: pixel

PIXEL_PER_CENTIMETER

public static final MeasureUnit PIXEL_PER_CENTIMETER

Constant for unit of graphics: pixel-per-centimeter

PIXEL_PER_INCH

public static final MeasureUnit PIXEL_PER_INCH

Constant for unit of graphics: pixel-per-inch

POINT

public static final MeasureUnit POINT

Constant for unit of length: point

POUND

public static final MeasureUnit POUND

Constant for unit of mass: pound

POUND_PER_SQUARE_INCH

public static final MeasureUnit POUND_PER_SQUARE_INCH

Constant for unit of pressure: pound-force-per-square-inch

QUART

public static final MeasureUnit QUART

Constant for unit of volume: quart

QUARTER

public static final MeasureUnit QUARTER

Constant for unit of duration: quarter

RADIAN

public static final MeasureUnit RADIAN

Constant for unit of angle: radian

REVOLUTION_ANGLE

public static final MeasureUnit REVOLUTION_ANGLE

Constant for unit of angle: revolution

SECOND

public static final TimeUnit SECOND

Constant for unit of duration: second

SQUARE_CENTIMETER

public static final MeasureUnit SQUARE_CENTIMETER

Constant for unit of area: square-centimeter

SQUARE_FOOT

public static final MeasureUnit SQUARE_FOOT

Constant for unit of area: square-foot

SQUARE_INCH

public static final MeasureUnit SQUARE_INCH

Constant for unit of area: square-inch

SQUARE_KILOMETER

public static final MeasureUnit SQUARE_KILOMETER

Constant for unit of area: square-kilometer

SQUARE_METER

public static final MeasureUnit SQUARE_METER

Constant for unit of area: square-meter

SQUARE_MILE

public static final MeasureUnit SQUARE_MILE

Constant for unit of area: square-mile

SQUARE_YARD

public static final MeasureUnit SQUARE_YARD

Constant for unit of area: square-yard

STONE

public static final MeasureUnit STONE

Constant for unit of mass: stone

TABLESPOON

public static final MeasureUnit TABLESPOON

Constant for unit of volume: tablespoon

TEASPOON

public static final MeasureUnit TEASPOON

Constant for unit of volume: teaspoon

TERABIT

public static final MeasureUnit TERABIT

Constant for unit of digital: terabit

TERABYTE

public static final MeasureUnit TERABYTE

Constant for unit of digital: terabyte

TON

public static final MeasureUnit TON

Constant for unit of mass: ton

TONNE

public static final MeasureUnit TONNE

Constant for unit of mass: tonne

VOLT

public static final MeasureUnit VOLT

Constant for unit of electric: volt

WATT

public static final MeasureUnit WATT

Constant for unit of power: watt

WEEK

public static final TimeUnit WEEK

Constant for unit of duration: week

YARD

public static final MeasureUnit YARD

Constant for unit of length: yard

YEAR

public static final TimeUnit YEAR

Constant for unit of duration: year

equals

public boolean equals (Object rhs)

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

• It is reflexive: for any non-null reference value x, x.equals(x) should return true.
• It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
• It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
• It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
• For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

forIdentifier

public static MeasureUnit forIdentifier (String identifier)

Construct a MeasureUnit from a CLDR Core Unit Identifier, defined in UTS 35. (Core unit identifiers and mixed unit identifiers are supported, long unit identifiers are not.) Validates and canonicalizes the identifier. Note: dimensionless MeasureUnit is null

 MeasureUnit example = MeasureUnit::forIdentifier("furlong-per-nanosecond")
 

getAvailable

public static Set<MeasureUnit> getAvailable (String type)

For the given type, return the available units.

getAvailable

public static Set<MeasureUnit> getAvailable ()

Get all of the available units. Returned set is unmodifiable.

getAvailableTypes

public static Set<String> getAvailableTypes ()

Get all of the available units' types. Returned set is unmodifiable.

getComplexity

public MeasureUnit.Complexity getComplexity ()

Compute the complexity of the unit. See Complexity for more information.

getDimensionality

public int getDimensionality ()

Returns the dimensionality (power) of this MeasureUnit. For example, if the unit is square, then 2 is returned.

NOTE: Only works on SINGLE units. If this is a COMPOUND or MIXED unit, an exception will be thrown. For more information, Complexity.

getIdentifier

public String getIdentifier ()

Get CLDR Unit Identifier for this MeasureUnit, as defined in UTS 35.

getPrefix

public MeasureUnit.MeasurePrefix getPrefix ()

Returns the current SI or binary prefix of this SINGLE unit. For example, if the unit has the prefix "kilo", then MeasurePrefix.KILO is returned.

NOTE: Only works on SINGLE units. If this is a COMPOUND or MIXED unit, an error will occur. For more information, Complexity.

getSubtype

public String getSubtype ()

Get the subType, such as \u201cfoot\u201d. May return null.

getType

public String getType ()

Get the type, such as "length". May return null.

hashCode

public int hashCode ()

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.

The general contract of hashCode is:

• Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
• If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
• It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

product

public MeasureUnit product (MeasureUnit other)

Computes the product of this unit with another unit. This is a way to build units from constituent parts.

The numerator and denominator are preserved through this operation.

For example, if the receiver is "kilowatt" and the argument is "hour-per-day", then the unit "kilowatt-hour-per-day" is returned.

NOTE: Only works on SINGLE and COMPOUND units. If either unit (receivee and argument) is a MIXED unit, an error will occur. For more information, Complexity.

reciprocal

public MeasureUnit reciprocal ()

Computes the reciprocal of this MeasureUnit, with the numerator and denominator flipped.

For example, if the receiver is "meter-per-second", the unit "second-per-meter" is returned.

NOTE: Only works on SINGLE and COMPOUND units. If this is a MIXED unit, an error will occur. For more information, Complexity.

splitToSingleUnits

public List<MeasureUnit> splitToSingleUnits ()

Returns the list of SINGLE units contained within a sequence of COMPOUND units.

Examples: - Given "meter-kilogram-per-second", three units will be returned: "meter", "kilogram", and "per-second". - Given "hour+minute+second", three units will be returned: "hour", "minute", and "second".

If this is a SINGLE unit, a list of length 1 will be returned.

toString

public String toString ()

Returns a string representation of the object.

withDimensionality

public MeasureUnit withDimensionality (int dimensionality)

Creates a MeasureUnit which is this SINGLE unit augmented with the specified dimensionality (power). For example, if dimensionality is 2, the unit will be squared.

NOTE: Only works on SINGLE units. If this is a COMPOUND or MIXED unit, an exception is thrown. For more information, Complexity.

withPrefix

public MeasureUnit withPrefix (MeasureUnit.MeasurePrefix prefix)

Creates a MeasureUnit which is this SINGLE unit augmented with the specified prefix. For example, MeasurePrefix.KILO for "kilo", or MeasurePrefix.KIBI for "kibi". May return this if this unit already has that prefix.

There is sufficient locale data to format all standard prefixes.

NOTE: Only works on SINGLE units. If this is a COMPOUND or MIXED unit, an error will occur. For more information, Complexity.