Class MeasureUnit

java.lang.Object
com.ibm.icu.util.MeasureUnit
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
Currency, TimeUnit
public class MeasureUnit extends Object implements Serializable
A unit such as length, mass, volume, currency, etc. A unit is coupled with a numeric amount to produce a Measure. MeasureUnit objects are immutable. All subclasses must guarantee that. (However, subclassing is discouraged.)
Author:
Alan Liu
See Also:
Status:
Stable ICU 3.0.

  • Field Details

    • type

      @Deprecated protected final String type
      Deprecated.
      This API is ICU internal only.
      If type set to null, measureUnitImpl is in use instead of type and subType.
      Status:
      Internal. This API is ICU internal only.

    • subType

      @Deprecated protected final String subType
      Deprecated.
      This API is ICU internal only.
      If subType set to null, measureUnitImpl is in use instead of type and subType.
      Status:
      Internal. This API is ICU internal only.

    • G_FORCE

      public static final MeasureUnit G_FORCE
      Constant for unit of acceleration: g-force
      Status:
      Stable ICU 53.

    • METER_PER_SECOND_SQUARED

      public static final MeasureUnit METER_PER_SECOND_SQUARED
      Constant for unit of acceleration: meter-per-square-second
      Status:
      Stable ICU 54.

    • ARC_MINUTE

      public static final MeasureUnit ARC_MINUTE
      Constant for unit of angle: arc-minute
      Status:
      Stable ICU 53.

    • ARC_SECOND

      public static final MeasureUnit ARC_SECOND
      Constant for unit of angle: arc-second
      Status:
      Stable ICU 53.

    • DEGREE

      public static final MeasureUnit DEGREE
      Constant for unit of angle: degree
      Status:
      Stable ICU 53.

    • RADIAN

      public static final MeasureUnit RADIAN
      Constant for unit of angle: radian
      Status:
      Stable ICU 54.

    • REVOLUTION_ANGLE

      public static final MeasureUnit REVOLUTION_ANGLE
      Constant for unit of angle: revolution
      Status:
      Stable ICU 56.

    • STERADIAN

      public static final MeasureUnit STERADIAN
      Constant for unit of angle: steradian
      Status:
      Draft ICU 78.

    • ACRE

      public static final MeasureUnit ACRE
      Constant for unit of area: acre
      Status:
      Stable ICU 53.

    • BU_JP

      public static final MeasureUnit BU_JP
      Constant for unit of area: bu-jp
      Status:
      Draft ICU 78.

    • CHO

      public static final MeasureUnit CHO
      Constant for unit of area: cho
      Status:
      Draft ICU 78.

    • DUNAM

      public static final MeasureUnit DUNAM
      Constant for unit of area: dunam
      Status:
      Stable ICU 64.

    • HECTARE

      public static final MeasureUnit HECTARE
      Constant for unit of area: hectare
      Status:
      Stable ICU 53.

    • SE_JP

      public static final MeasureUnit SE_JP
      Constant for unit of area: se-jp
      Status:
      Draft ICU 78.

    • SQUARE_CENTIMETER

      public static final MeasureUnit SQUARE_CENTIMETER
      Constant for unit of area: square-centimeter
      Status:
      Stable ICU 54.

    • SQUARE_FOOT

      public static final MeasureUnit SQUARE_FOOT
      Constant for unit of area: square-foot
      Status:
      Stable ICU 53.

    • SQUARE_INCH

      public static final MeasureUnit SQUARE_INCH
      Constant for unit of area: square-inch
      Status:
      Stable ICU 54.

    • SQUARE_KILOMETER

      public static final MeasureUnit SQUARE_KILOMETER
      Constant for unit of area: square-kilometer
      Status:
      Stable ICU 53.

    • SQUARE_METER

      public static final MeasureUnit SQUARE_METER
      Constant for unit of area: square-meter
      Status:
      Stable ICU 53.

    • SQUARE_MILE

      public static final MeasureUnit SQUARE_MILE
      Constant for unit of area: square-mile
      Status:
      Stable ICU 53.

    • SQUARE_YARD

      public static final MeasureUnit SQUARE_YARD
      Constant for unit of area: square-yard
      Status:
      Stable ICU 54.

    • ITEM

      public static final MeasureUnit ITEM
      Constant for unit of concentr: item
      Status:
      Stable ICU 70.

    • KARAT

      public static final MeasureUnit KARAT
      Constant for unit of concentr: karat
      Status:
      Stable ICU 54.

    • KATAL

      public static final MeasureUnit KATAL
      Constant for unit of concentr: katal
      Status:
      Draft ICU 78.

    • MILLIGRAM_OFGLUCOSE_PER_DECILITER

      public static final MeasureUnit MILLIGRAM_OFGLUCOSE_PER_DECILITER
      Constant for unit of concentr: milligram-ofglucose-per-deciliter
      Status:
      Stable ICU 69.

    • MILLIGRAM_PER_DECILITER

      @Deprecated public static final MeasureUnit MILLIGRAM_PER_DECILITER
      Deprecated.
      ICU 78 use MILLIGRAM_OFGLUCOSE_PER_DECILITER
      Constant for unit of concentr: milligram-per-deciliter (renamed to milligram-ofglucose-per-deciliter in CLDR 39 / ICU 69).

    • MILLIMOLE_PER_LITER

      public static final MeasureUnit MILLIMOLE_PER_LITER
      Constant for unit of concentr: millimole-per-liter
      Status:
      Stable ICU 57.

    • MOLE

      public static final MeasureUnit MOLE
      Constant for unit of concentr: mole
      Status:
      Stable ICU 64.

    • OFGLUCOSE

      public static final MeasureUnit OFGLUCOSE
      Constant for unit of concentr: ofglucose
      Status:
      Draft ICU 78.

    • PART

      public static final MeasureUnit PART
      Constant for unit of concentr: part
      Status:
      Draft ICU 78.

    • PART_PER_1E6

      public static final MeasureUnit PART_PER_1E6
      Constant for unit of concentr: part-per-1e6
      Status:
      Draft ICU 78.

    • PART_PER_MILLION

      public static final MeasureUnit PART_PER_MILLION
      Constant for unit of concentr: part-per-million (renamed to part-per-1e6 in CLDR 48 / ICU 78).
      Status:
      Stable ICU 57.

    • PART_PER_1E9

      public static final MeasureUnit PART_PER_1E9
      Constant for unit of concentr: part-per-1e9
      Status:
      Draft ICU 78.

    • PERCENT

      public static final MeasureUnit PERCENT
      Constant for unit of concentr: percent
      Status:
      Stable ICU 63.

    • PERMILLE

      public static final MeasureUnit PERMILLE
      Constant for unit of concentr: permille
      Status:
      Stable ICU 63.

    • PERMYRIAD

      public static final MeasureUnit PERMYRIAD
      Constant for unit of concentr: permyriad
      Status:
      Stable ICU 64.

    • LITER_PER_100KILOMETERS

      public static final MeasureUnit LITER_PER_100KILOMETERS
      Constant for unit of consumption: liter-per-100-kilometer
      Status:
      Stable ICU 56.

    • LITER_PER_KILOMETER

      public static final MeasureUnit LITER_PER_KILOMETER
      Constant for unit of consumption: liter-per-kilometer
      Status:
      Stable ICU 54.

    • MILE_PER_GALLON

      public static final MeasureUnit MILE_PER_GALLON
      Constant for unit of consumption: mile-per-gallon
      Status:
      Stable ICU 54.

    • MILE_PER_GALLON_IMPERIAL

      public static final MeasureUnit MILE_PER_GALLON_IMPERIAL
      Constant for unit of consumption: mile-per-gallon-imperial
      Status:
      Stable ICU 57.

    • BIT

      public static final MeasureUnit BIT
      Constant for unit of digital: bit
      Status:
      Stable ICU 54.

    • BYTE

      public static final MeasureUnit BYTE
      Constant for unit of digital: byte
      Status:
      Stable ICU 54.

    • GIGABIT

      public static final MeasureUnit GIGABIT
      Constant for unit of digital: gigabit
      Status:
      Stable ICU 54.

    • GIGABYTE

      public static final MeasureUnit GIGABYTE
      Constant for unit of digital: gigabyte
      Status:
      Stable ICU 54.

    • KILOBIT

      public static final MeasureUnit KILOBIT
      Constant for unit of digital: kilobit
      Status:
      Stable ICU 54.

    • KILOBYTE

      public static final MeasureUnit KILOBYTE
      Constant for unit of digital: kilobyte
      Status:
      Stable ICU 54.

    • MEGABIT

      public static final MeasureUnit MEGABIT
      Constant for unit of digital: megabit
      Status:
      Stable ICU 54.

    • MEGABYTE

      public static final MeasureUnit MEGABYTE
      Constant for unit of digital: megabyte
      Status:
      Stable ICU 54.

    • PETABYTE

      public static final MeasureUnit PETABYTE
      Constant for unit of digital: petabyte
      Status:
      Stable ICU 63.

    • TERABIT

      public static final MeasureUnit TERABIT
      Constant for unit of digital: terabit
      Status:
      Stable ICU 54.

    • TERABYTE

      public static final MeasureUnit TERABYTE
      Constant for unit of digital: terabyte
      Status:
      Stable ICU 54.

    • CENTURY

      public static final MeasureUnit CENTURY
      Constant for unit of duration: century
      Status:
      Stable ICU 56.

    • DAY

      public static final TimeUnit DAY
      Constant for unit of duration: day
      Status:
      Stable ICU 4.0.

    • DAY_PERSON

      public static final MeasureUnit DAY_PERSON
      Constant for unit of duration: day-person
      Status:
      Stable ICU 64.

    • DECADE

      public static final MeasureUnit DECADE
      Constant for unit of duration: decade
      Status:
      Stable ICU 65.

    • FORTNIGHT

      public static final MeasureUnit FORTNIGHT
      Constant for unit of duration: fortnight
      Status:
      Draft ICU 78.

    • HOUR

      public static final TimeUnit HOUR
      Constant for unit of duration: hour
      Status:
      Stable ICU 4.0.

    • MICROSECOND

      public static final MeasureUnit MICROSECOND
      Constant for unit of duration: microsecond
      Status:
      Stable ICU 54.

    • MILLISECOND

      public static final MeasureUnit MILLISECOND
      Constant for unit of duration: millisecond
      Status:
      Stable ICU 53.

    • MINUTE

      public static final TimeUnit MINUTE
      Constant for unit of duration: minute
      Status:
      Stable ICU 4.0.

    • MONTH

      public static final TimeUnit MONTH
      Constant for unit of duration: month
      Status:
      Stable ICU 4.0.

    • MONTH_PERSON

      public static final MeasureUnit MONTH_PERSON
      Constant for unit of duration: month-person
      Status:
      Stable ICU 64.

    • NANOSECOND

      public static final MeasureUnit NANOSECOND
      Constant for unit of duration: nanosecond
      Status:
      Stable ICU 54.

    • NIGHT

      public static final MeasureUnit NIGHT
      Constant for unit of duration: night
      Status:
      Stable ICU 76.

    • QUARTER

      public static final MeasureUnit QUARTER
      Constant for unit of duration: quarter
      Status:
      Stable ICU 72.

    • SECOND

      public static final TimeUnit SECOND
      Constant for unit of duration: second
      Status:
      Stable ICU 4.0.

    • WEEK

      public static final TimeUnit WEEK
      Constant for unit of duration: week
      Status:
      Stable ICU 4.0.

    • WEEK_PERSON

      public static final MeasureUnit WEEK_PERSON
      Constant for unit of duration: week-person
      Status:
      Stable ICU 64.

    • YEAR

      public static final TimeUnit YEAR
      Constant for unit of duration: year
      Status:
      Stable ICU 4.0.

    • YEAR_PERSON

      public static final MeasureUnit YEAR_PERSON
      Constant for unit of duration: year-person
      Status:
      Stable ICU 64.

    • AMPERE

      public static final MeasureUnit AMPERE
      Constant for unit of electric: ampere
      Status:
      Stable ICU 54.

    • COULOMB

      public static final MeasureUnit COULOMB
      Constant for unit of electric: coulomb
      Status:
      Draft ICU 78.

    • FARAD

      public static final MeasureUnit FARAD
      Constant for unit of electric: farad
      Status:
      Draft ICU 78.

    • HENRY

      public static final MeasureUnit HENRY
      Constant for unit of electric: henry
      Status:
      Draft ICU 78.

    • MILLIAMPERE

      public static final MeasureUnit MILLIAMPERE
      Constant for unit of electric: milliampere
      Status:
      Stable ICU 54.

    • OHM

      public static final MeasureUnit OHM
      Constant for unit of electric: ohm
      Status:
      Stable ICU 54.

    • SIEMENS

      public static final MeasureUnit SIEMENS
      Constant for unit of electric: siemens
      Status:
      Draft ICU 78.

    • VOLT

      public static final MeasureUnit VOLT
      Constant for unit of electric: volt
      Status:
      Stable ICU 54.

    • BECQUEREL

      public static final MeasureUnit BECQUEREL
      Constant for unit of energy: becquerel
      Status:
      Draft ICU 78.

    • BRITISH_THERMAL_UNIT

      public static final MeasureUnit BRITISH_THERMAL_UNIT
      Constant for unit of energy: british-thermal-unit
      Status:
      Stable ICU 64.

    • BRITISH_THERMAL_UNIT_IT

      public static final MeasureUnit BRITISH_THERMAL_UNIT_IT
      Constant for unit of energy: british-thermal-unit-it
      Status:
      Draft ICU 78.

    • CALORIE

      public static final MeasureUnit CALORIE
      Constant for unit of energy: calorie
      Status:
      Stable ICU 54.

    • CALORIE_IT

      public static final MeasureUnit CALORIE_IT
      Constant for unit of energy: calorie-it
      Status:
      Draft ICU 78.

    • ELECTRONVOLT

      public static final MeasureUnit ELECTRONVOLT
      Constant for unit of energy: electronvolt
      Status:
      Stable ICU 64.

    • FOODCALORIE

      public static final MeasureUnit FOODCALORIE
      Constant for unit of energy: foodcalorie
      Status:
      Stable ICU 54.

    • GRAY

      public static final MeasureUnit GRAY
      Constant for unit of energy: gray
      Status:
      Draft ICU 78.

    • JOULE

      public static final MeasureUnit JOULE
      Constant for unit of energy: joule
      Status:
      Stable ICU 54.

    • KILOCALORIE

      public static final MeasureUnit KILOCALORIE
      Constant for unit of energy: kilocalorie
      Status:
      Stable ICU 54.

    • KILOJOULE

      public static final MeasureUnit KILOJOULE
      Constant for unit of energy: kilojoule
      Status:
      Stable ICU 54.

    • KILOWATT_HOUR

      public static final MeasureUnit KILOWATT_HOUR
      Constant for unit of energy: kilowatt-hour
      Status:
      Stable ICU 54.

    • SIEVERT

      public static final MeasureUnit SIEVERT
      Constant for unit of energy: sievert
      Status:
      Draft ICU 78.

    • THERM_US

      public static final MeasureUnit THERM_US
      Constant for unit of energy: therm-us
      Status:
      Stable ICU 65.

    • DYNE

      public static final MeasureUnit DYNE
      Constant for unit of force: dyne
      Status:
      Draft ICU 79.

    • KILOGRAM_FORCE

      public static final MeasureUnit KILOGRAM_FORCE
      Constant for unit of force: kilogram-force
      Status:
      Draft ICU 78.

    • KILOWATT_HOUR_PER_100_KILOMETER

      public static final MeasureUnit KILOWATT_HOUR_PER_100_KILOMETER
      Constant for unit of force: kilowatt-hour-per-100-kilometer
      Status:
      Stable ICU 70.

    • NEWTON

      public static final MeasureUnit NEWTON
      Constant for unit of force: newton
      Status:
      Stable ICU 64.

    • POUND_FORCE

      public static final MeasureUnit POUND_FORCE
      Constant for unit of force: pound-force
      Status:
      Stable ICU 64.

    • POUNDAL

      public static final MeasureUnit POUNDAL
      Constant for unit of force: poundal
      Status:
      Draft ICU 79.

    • GIGAHERTZ

      public static final MeasureUnit GIGAHERTZ
      Constant for unit of frequency: gigahertz
      Status:
      Stable ICU 54.

    • HERTZ

      public static final MeasureUnit HERTZ
      Constant for unit of frequency: hertz
      Status:
      Stable ICU 54.

    • KILOHERTZ

      public static final MeasureUnit KILOHERTZ
      Constant for unit of frequency: kilohertz
      Status:
      Stable ICU 54.

    • MEGAHERTZ

      public static final MeasureUnit MEGAHERTZ
      Constant for unit of frequency: megahertz
      Status:
      Stable ICU 54.

    • DOT

      public static final MeasureUnit DOT
      Constant for unit of graphics: dot
      Status:
      Stable ICU 68.

    • DOT_PER_CENTIMETER

      public static final MeasureUnit DOT_PER_CENTIMETER
      Constant for unit of graphics: dot-per-centimeter
      Status:
      Stable ICU 65.

    • DOT_PER_INCH

      public static final MeasureUnit DOT_PER_INCH
      Constant for unit of graphics: dot-per-inch
      Status:
      Stable ICU 65.

    • EM

      public static final MeasureUnit EM
      Constant for unit of graphics: em
      Status:
      Stable ICU 65.

    • MEGAPIXEL

      public static final MeasureUnit MEGAPIXEL
      Constant for unit of graphics: megapixel
      Status:
      Stable ICU 65.

    • PIXEL

      public static final MeasureUnit PIXEL
      Constant for unit of graphics: pixel
      Status:
      Stable ICU 65.

    • PIXEL_PER_CENTIMETER

      public static final MeasureUnit PIXEL_PER_CENTIMETER
      Constant for unit of graphics: pixel-per-centimeter
      Status:
      Stable ICU 65.

    • PIXEL_PER_INCH

      public static final MeasureUnit PIXEL_PER_INCH
      Constant for unit of graphics: pixel-per-inch
      Status:
      Stable ICU 65.

    • ASTRONOMICAL_UNIT

      public static final MeasureUnit ASTRONOMICAL_UNIT
      Constant for unit of length: astronomical-unit
      Status:
      Stable ICU 54.

    • CENTIMETER

      public static final MeasureUnit CENTIMETER
      Constant for unit of length: centimeter
      Status:
      Stable ICU 53.

    • CHAIN

      public static final MeasureUnit CHAIN
      Constant for unit of length: chain
      Status:
      Draft ICU 78.

    • DECIMETER

      public static final MeasureUnit DECIMETER
      Constant for unit of length: decimeter
      Status:
      Stable ICU 54.

    • EARTH_RADIUS

      public static final MeasureUnit EARTH_RADIUS
      Constant for unit of length: earth-radius
      Status:
      Stable ICU 68.

    • FATHOM

      public static final MeasureUnit FATHOM
      Constant for unit of length: fathom
      Status:
      Stable ICU 54.

    • FURLONG

      public static final MeasureUnit FURLONG
      Constant for unit of length: furlong
      Status:
      Stable ICU 54.

    • INCH

      public static final MeasureUnit INCH
      Constant for unit of length: inch
      Status:
      Stable ICU 53.

    • JO_JP

      public static final MeasureUnit JO_JP
      Constant for unit of length: jo-jp
      Status:
      Draft ICU 78.

    • KEN

      public static final MeasureUnit KEN
      Constant for unit of length: ken
      Status:
      Draft ICU 78.

    • KILOMETER

      public static final MeasureUnit KILOMETER
      Constant for unit of length: kilometer
      Status:
      Stable ICU 53.

    • LIGHT_YEAR

      public static final MeasureUnit LIGHT_YEAR
      Constant for unit of length: light-year
      Status:
      Stable ICU 53.

    • METER

      public static final MeasureUnit METER
      Constant for unit of length: meter
      Status:
      Stable ICU 53.

    • MICROMETER

      public static final MeasureUnit MICROMETER
      Constant for unit of length: micrometer
      Status:
      Stable ICU 54.

    • MILE

      public static final MeasureUnit MILE
      Constant for unit of length: mile
      Status:
      Stable ICU 53.

    • MILE_SCANDINAVIAN

      public static final MeasureUnit MILE_SCANDINAVIAN
      Constant for unit of length: mile-scandinavian
      Status:
      Stable ICU 56.

    • MILLIINCH

      public static final MeasureUnit MILLIINCH
      Constant for unit of length: milliinch
      Status:
      Draft ICU 79.

    • MILLIMETER

      public static final MeasureUnit MILLIMETER
      Constant for unit of length: millimeter
      Status:
      Stable ICU 53.

    • NANOMETER

      public static final MeasureUnit NANOMETER
      Constant for unit of length: nanometer
      Status:
      Stable ICU 54.

    • NAUTICAL_MILE

      public static final MeasureUnit NAUTICAL_MILE
      Constant for unit of length: nautical-mile
      Status:
      Stable ICU 54.

    • PARSEC

      public static final MeasureUnit PARSEC
      Constant for unit of length: parsec
      Status:
      Stable ICU 54.

    • PICOMETER

      public static final MeasureUnit PICOMETER
      Constant for unit of length: picometer
      Status:
      Stable ICU 53.

    • POINT

      public static final MeasureUnit POINT
      Constant for unit of length: point
      Status:
      Stable ICU 59.

    • RI_JP

      public static final MeasureUnit RI_JP
      Constant for unit of length: ri-jp
      Status:
      Draft ICU 78.

    • RIN

      public static final MeasureUnit RIN
      Constant for unit of length: rin
      Status:
      Draft ICU 78.

    • ROD

      public static final MeasureUnit ROD
      Constant for unit of length: rod
      Status:
      Draft ICU 78.

    • SHAKU_CLOTH

      public static final MeasureUnit SHAKU_CLOTH
      Constant for unit of length: shaku-cloth
      Status:
      Draft ICU 78.

    • SHAKU_LENGTH

      public static final MeasureUnit SHAKU_LENGTH
      Constant for unit of length: shaku-length
      Status:
      Draft ICU 78.

    • SOLAR_RADIUS

      public static final MeasureUnit SOLAR_RADIUS
      Constant for unit of length: solar-radius
      Status:
      Stable ICU 64.

    • SUN

      public static final MeasureUnit SUN
      Constant for unit of length: sun
      Status:
      Draft ICU 78.

    • YARD

      public static final MeasureUnit YARD
      Constant for unit of length: yard
      Status:
      Stable ICU 53.

    • CANDELA

      public static final MeasureUnit CANDELA
      Constant for unit of light: candela
      Status:
      Stable ICU 68.

    • LUMEN

      public static final MeasureUnit LUMEN
      Constant for unit of light: lumen
      Status:
      Stable ICU 68.

    • LUX

      public static final MeasureUnit LUX
      Constant for unit of light: lux
      Status:
      Stable ICU 54.

    • SOLAR_LUMINOSITY

      public static final MeasureUnit SOLAR_LUMINOSITY
      Constant for unit of light: solar-luminosity
      Status:
      Stable ICU 64.

    • TESLA

      public static final MeasureUnit TESLA
      Constant for unit of magnetic: tesla
      Status:
      Draft ICU 78.

    • WEBER

      public static final MeasureUnit WEBER
      Constant for unit of magnetic: weber
      Status:
      Draft ICU 78.

    • CARAT

      public static final MeasureUnit CARAT
      Constant for unit of mass: carat
      Status:
      Stable ICU 54.

    • DALTON

      public static final MeasureUnit DALTON
      Constant for unit of mass: dalton
      Status:
      Stable ICU 64.

    • EARTH_MASS

      public static final MeasureUnit EARTH_MASS
      Constant for unit of mass: earth-mass
      Status:
      Stable ICU 64.

    • FUN

      public static final MeasureUnit FUN
      Constant for unit of mass: fun
      Status:
      Draft ICU 78.

    • GRAIN

      public static final MeasureUnit GRAIN
      Constant for unit of mass: grain
      Status:
      Stable ICU 68.

    • GRAM

      public static final MeasureUnit GRAM
      Constant for unit of mass: gram
      Status:
      Stable ICU 53.

    • KILOGRAM

      public static final MeasureUnit KILOGRAM
      Constant for unit of mass: kilogram
      Status:
      Stable ICU 53.

    • MICROGRAM

      public static final MeasureUnit MICROGRAM
      Constant for unit of mass: microgram
      Status:
      Stable ICU 54.

    • MILLIGRAM

      public static final MeasureUnit MILLIGRAM
      Constant for unit of mass: milligram
      Status:
      Stable ICU 54.

    • OUNCE

      public static final MeasureUnit OUNCE
      Constant for unit of mass: ounce
      Status:
      Stable ICU 53.

    • OUNCE_TROY

      public static final MeasureUnit OUNCE_TROY
      Constant for unit of mass: ounce-troy
      Status:
      Stable ICU 54.

    • POUND

      public static final MeasureUnit POUND
      Constant for unit of mass: pound
      Status:
      Stable ICU 53.

    • SLUG

      public static final MeasureUnit SLUG
      Constant for unit of mass: slug
      Status:
      Draft ICU 78.

    • SOLAR_MASS

      public static final MeasureUnit SOLAR_MASS
      Constant for unit of mass: solar-mass
      Status:
      Stable ICU 64.

    • STONE

      public static final MeasureUnit STONE
      Constant for unit of mass: stone
      Status:
      Stable ICU 54.

    • TON

      public static final MeasureUnit TON
      Constant for unit of mass: ton
      Status:
      Stable ICU 54.

    • TONNE

      public static final MeasureUnit TONNE
      Constant for unit of mass: tonne
      Status:
      Stable ICU 72.

    • METRIC_TON

      @Deprecated public static final MeasureUnit METRIC_TON
      Deprecated.
      ICU 78 use TONNE
      Constant for unit of mass: metric-ton (renamed to tonne in CLDR 42 / ICU 72).

    • GIGAWATT

      public static final MeasureUnit GIGAWATT
      Constant for unit of power: gigawatt
      Status:
      Stable ICU 54.

    • HORSEPOWER

      public static final MeasureUnit HORSEPOWER
      Constant for unit of power: horsepower
      Status:
      Stable ICU 53.

    • KILOWATT

      public static final MeasureUnit KILOWATT
      Constant for unit of power: kilowatt
      Status:
      Stable ICU 53.

    • MEGAWATT

      public static final MeasureUnit MEGAWATT
      Constant for unit of power: megawatt
      Status:
      Stable ICU 54.

    • MILLIWATT

      public static final MeasureUnit MILLIWATT
      Constant for unit of power: milliwatt
      Status:
      Stable ICU 54.

    • WATT

      public static final MeasureUnit WATT
      Constant for unit of power: watt
      Status:
      Stable ICU 53.

    • ATMOSPHERE

      public static final MeasureUnit ATMOSPHERE
      Constant for unit of pressure: atmosphere
      Status:
      Stable ICU 63.

    • BAR

      public static final MeasureUnit BAR
      Constant for unit of pressure: bar
      Status:
      Stable ICU 65.

    • GASOLINE_ENERGY_DENSITY

      public static final MeasureUnit GASOLINE_ENERGY_DENSITY
      Constant for unit of pressure: gasoline-energy-density
      Status:
      Stable ICU 74.

    • HECTOPASCAL

      public static final MeasureUnit HECTOPASCAL
      Constant for unit of pressure: hectopascal
      Status:
      Stable ICU 53.

    • INCH_HG

      public static final MeasureUnit INCH_HG
      Constant for unit of pressure: inch-ofhg
      Status:
      Stable ICU 53.

    • KILOPASCAL

      public static final MeasureUnit KILOPASCAL
      Constant for unit of pressure: kilopascal
      Status:
      Stable ICU 64.

    • MEGAPASCAL

      public static final MeasureUnit MEGAPASCAL
      Constant for unit of pressure: megapascal
      Status:
      Stable ICU 64.

    • MILLIBAR

      public static final MeasureUnit MILLIBAR
      Constant for unit of pressure: millibar
      Status:
      Stable ICU 53.

    • MILLIMETER_OF_MERCURY

      public static final MeasureUnit MILLIMETER_OF_MERCURY
      Constant for unit of pressure: millimeter-ofhg
      Status:
      Stable ICU 54.

    • OFHG

      public static final MeasureUnit OFHG
      Constant for unit of pressure: ofhg
      Status:
      Draft ICU 78.

    • PASCAL

      public static final MeasureUnit PASCAL
      Constant for unit of pressure: pascal
      Status:
      Stable ICU 65.

    • POUND_PER_SQUARE_INCH

      public static final MeasureUnit POUND_PER_SQUARE_INCH
      Constant for unit of pressure: pound-force-per-square-inch
      Status:
      Stable ICU 54.

    • BEAUFORT

      public static final MeasureUnit BEAUFORT
      Constant for unit of speed: beaufort
      Status:
      Stable ICU 73.

    • KILOMETER_PER_HOUR

      public static final MeasureUnit KILOMETER_PER_HOUR
      Constant for unit of speed: kilometer-per-hour
      Status:
      Stable ICU 53.

    • KNOT

      public static final MeasureUnit KNOT
      Constant for unit of speed: knot
      Status:
      Stable ICU 56.

    • LIGHT_SPEED

      public static final MeasureUnit LIGHT_SPEED
      Constant for unit of speed: light-speed
      Status:
      Stable ICU 76.

    • METER_PER_SECOND

      public static final MeasureUnit METER_PER_SECOND
      Constant for unit of speed: meter-per-second
      Status:
      Stable ICU 53.

    • MILE_PER_HOUR

      public static final MeasureUnit MILE_PER_HOUR
      Constant for unit of speed: mile-per-hour
      Status:
      Stable ICU 53.

    • CELSIUS

      public static final MeasureUnit CELSIUS
      Constant for unit of temperature: celsius
      Status:
      Stable ICU 53.

    • FAHRENHEIT

      public static final MeasureUnit FAHRENHEIT
      Constant for unit of temperature: fahrenheit
      Status:
      Stable ICU 53.

    • GENERIC_TEMPERATURE

      public static final MeasureUnit GENERIC_TEMPERATURE
      Constant for unit of temperature: generic
      Status:
      Stable ICU 56.

    • KELVIN

      public static final MeasureUnit KELVIN
      Constant for unit of temperature: kelvin
      Status:
      Stable ICU 54.

    • RANKINE

      public static final MeasureUnit RANKINE
      Constant for unit of temperature: rankine
      Status:
      Draft ICU 78.

    • NEWTON_METER

      public static final MeasureUnit NEWTON_METER
      Constant for unit of torque: newton-meter
      Status:
      Stable ICU 64.

    • POUND_FOOT

      public static final MeasureUnit POUND_FOOT
      Constant for unit of torque: pound-force-foot
      Status:
      Stable ICU 64.

    • ACRE_FOOT

      public static final MeasureUnit ACRE_FOOT
      Constant for unit of volume: acre-foot
      Status:
      Stable ICU 54.

    • BARREL

      public static final MeasureUnit BARREL
      Constant for unit of volume: barrel
      Status:
      Stable ICU 64.

    • BUSHEL

      public static final MeasureUnit BUSHEL
      Constant for unit of volume: bushel
      Status:
      Stable ICU 54.

    • CENTILITER

      public static final MeasureUnit CENTILITER
      Constant for unit of volume: centiliter
      Status:
      Stable ICU 54.

    • CUBIC_CENTIMETER

      public static final MeasureUnit CUBIC_CENTIMETER
      Constant for unit of volume: cubic-centimeter
      Status:
      Stable ICU 54.

    • CUBIC_FOOT

      public static final MeasureUnit CUBIC_FOOT
      Constant for unit of volume: cubic-foot
      Status:
      Stable ICU 54.

    • CUBIC_INCH

      public static final MeasureUnit CUBIC_INCH
      Constant for unit of volume: cubic-inch
      Status:
      Stable ICU 54.

    • CUBIC_KILOMETER

      public static final MeasureUnit CUBIC_KILOMETER
      Constant for unit of volume: cubic-kilometer
      Status:
      Stable ICU 53.

    • CUBIC_METER

      public static final MeasureUnit CUBIC_METER
      Constant for unit of volume: cubic-meter
      Status:
      Stable ICU 54.

    • CUBIC_MILE

      public static final MeasureUnit CUBIC_MILE
      Constant for unit of volume: cubic-mile
      Status:
      Stable ICU 53.

    • CUBIC_YARD

      public static final MeasureUnit CUBIC_YARD
      Constant for unit of volume: cubic-yard
      Status:
      Stable ICU 54.

    • CUP

      public static final MeasureUnit CUP
      Constant for unit of volume: cup
      Status:
      Stable ICU 54.

    • CUP_IMPERIAL

      public static final MeasureUnit CUP_IMPERIAL
      Constant for unit of volume: cup-imperial
      Status:
      Draft ICU 78.

    • CUP_JP

      public static final MeasureUnit CUP_JP
      Constant for unit of volume: cup-jp
      Status:
      Draft ICU 78.

    • CUP_METRIC

      public static final MeasureUnit CUP_METRIC
      Constant for unit of volume: cup-metric
      Status:
      Stable ICU 56.

    • DECILITER

      public static final MeasureUnit DECILITER
      Constant for unit of volume: deciliter
      Status:
      Stable ICU 54.

    • DESSERT_SPOON

      public static final MeasureUnit DESSERT_SPOON
      Constant for unit of volume: dessert-spoon
      Status:
      Stable ICU 68.

    • DESSERT_SPOON_IMPERIAL

      public static final MeasureUnit DESSERT_SPOON_IMPERIAL
      Constant for unit of volume: dessert-spoon-imperial
      Status:
      Stable ICU 68.

    • DRAM

      public static final MeasureUnit DRAM
      Constant for unit of volume: dram
      Status:
      Stable ICU 68.

    • DROP

      public static final MeasureUnit DROP
      Constant for unit of volume: drop
      Status:
      Stable ICU 68.

    • FLUID_OUNCE

      public static final MeasureUnit FLUID_OUNCE
      Constant for unit of volume: fluid-ounce
      Status:
      Stable ICU 54.

    • FLUID_OUNCE_IMPERIAL

      public static final MeasureUnit FLUID_OUNCE_IMPERIAL
      Constant for unit of volume: fluid-ounce-imperial
      Status:
      Stable ICU 64.

    • FLUID_OUNCE_METRIC

      public static final MeasureUnit FLUID_OUNCE_METRIC
      Constant for unit of volume: fluid-ounce-metric
      Status:
      Draft ICU 78.

    • GALLON

      public static final MeasureUnit GALLON
      Constant for unit of volume: gallon
      Status:
      Stable ICU 54.

    • GALLON_IMPERIAL

      public static final MeasureUnit GALLON_IMPERIAL
      Constant for unit of volume: gallon-imperial
      Status:
      Stable ICU 57.

    • HECTOLITER

      public static final MeasureUnit HECTOLITER
      Constant for unit of volume: hectoliter
      Status:
      Stable ICU 54.

    • JIGGER

      public static final MeasureUnit JIGGER
      Constant for unit of volume: jigger
      Status:
      Stable ICU 68.

    • KOKU

      public static final MeasureUnit KOKU
      Constant for unit of volume: koku
      Status:
      Draft ICU 78.

    • KOSAJI

      public static final MeasureUnit KOSAJI
      Constant for unit of volume: kosaji
      Status:
      Draft ICU 78.

    • LITER

      public static final MeasureUnit LITER
      Constant for unit of volume: liter
      Status:
      Stable ICU 53.

    • MEGALITER

      public static final MeasureUnit MEGALITER
      Constant for unit of volume: megaliter
      Status:
      Stable ICU 54.

    • MILLILITER

      public static final MeasureUnit MILLILITER
      Constant for unit of volume: milliliter
      Status:
      Stable ICU 54.

    • OSAJI

      public static final MeasureUnit OSAJI
      Constant for unit of volume: osaji
      Status:
      Draft ICU 78.

    • PINCH

      public static final MeasureUnit PINCH
      Constant for unit of volume: pinch
      Status:
      Stable ICU 68.

    • PINT

      public static final MeasureUnit PINT
      Constant for unit of volume: pint
      Status:
      Stable ICU 54.

    • PINT_IMPERIAL

      public static final MeasureUnit PINT_IMPERIAL
      Constant for unit of volume: pint-imperial
      Status:
      Draft ICU 78.

    • PINT_METRIC

      public static final MeasureUnit PINT_METRIC
      Constant for unit of volume: pint-metric
      Status:
      Stable ICU 56.

    • QUART

      public static final MeasureUnit QUART
      Constant for unit of volume: quart
      Status:
      Stable ICU 54.

    • QUART_IMPERIAL

      public static final MeasureUnit QUART_IMPERIAL
      Constant for unit of volume: quart-imperial
      Status:
      Stable ICU 68.

    • SAI

      public static final MeasureUnit SAI
      Constant for unit of volume: sai
      Status:
      Draft ICU 78.

    • SHAKU

      public static final MeasureUnit SHAKU
      Constant for unit of volume: shaku
      Status:
      Draft ICU 78.

    • TABLESPOON

      public static final MeasureUnit TABLESPOON
      Constant for unit of volume: tablespoon
      Status:
      Stable ICU 54.

    • TEASPOON

      public static final MeasureUnit TEASPOON
      Constant for unit of volume: teaspoon
      Status:
      Stable ICU 54.

    • TO_JP

      public static final MeasureUnit TO_JP
      Constant for unit of volume: to-jp
      Status:
      Draft ICU 78.

  • Constructor Details

    • MeasureUnit

      @Deprecated protected MeasureUnit(String type, String subType)
      Deprecated.
      This API is ICU internal only.
      Status:
      Internal. This API is ICU internal only.

  • Method Details

    • forIdentifier

      public static MeasureUnit forIdentifier(String identifier)
      Constructs a MeasureUnit from a CLDR Core Unit Identifier, as defined in UTS 35. This method supports core unit identifiers and mixed unit identifiers. It validates and canonicalizes the given identifier.

      Note: A dimensionless MeasureUnit is represented as null.

      Example usage: 

      MeasureUnit example = MeasureUnit.forIdentifier("meter-per-second);
      Parameters:
      identifier - the CLDR Unit Identifier
      Returns:
      the corresponding MeasureUnit
      Throws:
      IllegalArgumentException - if the identifier is invalid
      Status:
      Stable ICU 68.

    • fromMeasureUnitImpl

      @Deprecated public static MeasureUnit fromMeasureUnitImpl(com.ibm.icu.impl.units.MeasureUnitImpl measureUnitImpl)
      Deprecated.
      Internal API for ICU use only.
      Status:
      Internal. This API is ICU internal only.

    • getType

      public String getType()
      Get the type, such as "length". May return null.
      Status:
      Stable ICU 53.

    • getSubtype

      public String getSubtype()
      Get the subType, such as “foot”. May return null.
      Status:
      Stable ICU 53.

    • getIdentifier

      public String getIdentifier()
      Get CLDR Unit Identifier for this MeasureUnit, as defined in UTS 35.
      Returns:
      The string form of this unit.
      Status:
      Stable ICU 68.

    • getComplexity

      public MeasureUnit.Complexity getComplexity()
      Compute the complexity of the unit. See Complexity for more information.
      Returns:
      The unit complexity.
      Status:
      Stable ICU 68.

    • 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, MeasureUnit.Complexity.

      Parameters:
      prefix - The prefix, from MeasurePrefix.
      Returns:
      A new SINGLE unit.
      Throws:
      UnsupportedOperationException - if this unit is a COMPOUND or MIXED unit.
      Status:
      Stable ICU 69.

    • 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, MeasureUnit.Complexity.

      Returns:
      The prefix of this SINGLE unit, from MeasurePrefix.
      Throws:
      UnsupportedOperationException - if the unit is COMPOUND or MIXED.
      Status:
      Stable ICU 69.

    • withConstantDenominator

      public MeasureUnit withConstantDenominator(long denominator)
      Creates a new MeasureUnit with a specified constant denominator.

      This method is applicable only to COMPOUND & SINGLE units. If invoked on a MIXED unit, an exception will be thrown. For further details, refer to MeasureUnit.Complexity.

      NOTE: If the constant denominator is set to 0, it means that you are removing the constant denominator.

      Parameters:
      denominator - The constant denominator to set.
      Returns:
      A new MeasureUnit with the specified constant denominator.
      Throws:
      UnsupportedOperationException - if the unit is not a COMPOUND unit.
      Status:
      Draft ICU 77.

    • getConstantDenominator

      public long getConstantDenominator()
      Retrieves the constant denominator for this COMPOUND unit.

      Examples:

      • For the unit "liter-per-1000-kiloliter", the constant denominator is 1000.
      • For the unit "liter-per-kilometer", the constant denominator is zero.

      This method is applicable only to COMPOUND & SINGLE units. If invoked on a MIXED unit, an exception will be thrown. For further details, refer to MeasureUnit.Complexity.

      NOTE: If no constant denominator exists, the method returns 0.

      Returns:
      The value of the constant denominator.
      Throws:
      UnsupportedOperationException - if the unit is not a COMPOUND unit.
      Status:
      Draft ICU 77.

    • 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, MeasureUnit.Complexity.

      Returns:
      The dimensionality (power) of this simple unit.
      Throws:
      UnsupportedOperationException - if the unit is COMPOUND or MIXED.
      Status:
      Stable ICU 68.

    • 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, MeasureUnit.Complexity.

      Parameters:
      dimensionality - The dimensionality (power).
      Returns:
      A new SINGLE unit.
      Throws:
      UnsupportedOperationException - if the unit is COMPOUND or MIXED.
      Status:
      Stable ICU 68.

    • 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, MeasureUnit.Complexity.

      NOTE: An exception will be thrown for units that have a constant denominator.

      Returns:
      The reciprocal of the target unit.
      Throws:
      UnsupportedOperationException - if the unit is MIXED or has a constant denominator.
      Status:
      Stable ICU 68.

    • 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, MeasureUnit.Complexity.

      Parameters:
      other - The MeasureUnit to multiply with the target.
      Returns:
      The product of the target unit with the provided unit.
      Throws:
      UnsupportedOperationException - if the unit is MIXED.
      Status:
      Stable ICU 68.

    • 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.

      NOTE: For units with a constant denominator, the returned single units will not include the constant denominator. To obtain the constant denominator, retrieve it from the original unit.

      Returns:
      An unmodifiable list of single units
      Status:
      Stable ICU 68.

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
      Status:
      Stable ICU 3.0.

    • equals

      public boolean equals(Object rhs)
      Overrides:
      equals in class Object
      Status:
      Stable ICU 3.0.

    • toString

      public String toString()
      Overrides:
      toString in class Object
      Status:
      Stable ICU 3.0.

    • getAvailableTypes

      public static Set<String> getAvailableTypes()
      Get all of the available units' types. Returned set is unmodifiable.
      Status:
      Stable ICU 53.

    • getAvailable

      public static Set<MeasureUnit> getAvailable(String type)
      For the given type, return the available units.
      Parameters:
      type - the type
      Returns:
      the available units for type. Returned set is unmodifiable.
      Status:
      Stable ICU 53.

    • getAvailable

      public static Set<MeasureUnit> getAvailable()
      Get all of the available units. Returned set is unmodifiable.
      Status:
      Stable ICU 53.

    • internalGetInstance

      @Deprecated public static MeasureUnit internalGetInstance(String type, String subType)
      Deprecated.
      This API is ICU internal only.
      Creates a MeasureUnit instance (creates a singleton instance) or returns one from the cache.

      Normally this method should not be used, since there will be no formatting data available for it, and it may not be returned by getAvailable(). However, for special purposes (such as CLDR tooling), it is available.

      Status:
      Internal. This API is ICU internal only.

    • findBySubType

      @Deprecated public static MeasureUnit findBySubType(String subType)
      Deprecated.
      This API is ICU internal only.
      Status:
      Internal. This API is ICU internal only.

    • getUnit

      @Deprecated public static MeasureUnit getUnit(String type, String subtype)
      Deprecated.
      This API is ICU internal only.
      Returns the MeasureUnit instance if the given type and subtype combination is valid, or null otherwise.

      Example: "length", "meter" -> METER "length", "kilometer" -> KILOMETER "length", "kilometer-per-hour" -> null --> not valid

      Parameters:
      type - the unit type (e.g., "length", "mass", "volume")
      subtype - the unit subtype (e.g., "meter", "kilogram", "liter")
      Returns:
      the MeasureUnit if valid, otherwise null
      Status:
      Internal. This API is ICU internal only.

    • validateAndGet

      @Deprecated public static MeasureUnit validateAndGet(String type, String subtype)
      Deprecated.
      This API is ICU internal only.
      Returns the MeasureUnit instance if the given type and subtype combination is valid, or null otherwise.
      Parameters:
      type - the unit type (e.g., "length", "mass", "volume")
      subtype - the unit subtype (e.g., "meter", "kilogram", "liter")
      Returns:
      the MeasureUnit if valid, otherwise null
      Status:
      Internal. This API is ICU internal only.

    • addUnit

      @Deprecated protected static MeasureUnit addUnit(String type, String unitName, MeasureUnit.Factory factory)
      Deprecated.
      This API is ICU internal only.
      Status:
      Internal. This API is ICU internal only.

    • getCopyOfMeasureUnitImpl

      @Deprecated public com.ibm.icu.impl.units.MeasureUnitImpl getCopyOfMeasureUnitImpl()
      Deprecated.
      This API is ICU internal only.
      Returns:
      this object in a MeasureUnitImpl form.
      Status:
      Internal. This API is ICU internal only.