Units (Units of Measurement Reference Implementation 2.1.2 API)

java.lang.Object
- tech.units.indriya.AbstractSystemOfUnits
- - tech.units.indriya.unit.Units

All Implemented Interfaces:

javax.measure.spi.SystemOfUnits, tech.uom.lib.common.function.Nameable
```
public class Units
extends AbstractSystemOfUnits
```
This class defines common units.

Since:

1.0

Version:

2.3.1, April 21, 2020

Author:

Werner Keil, Thodoris Bais

See Also:

USMA: Detailed list of metric system units, symbols, and prefixes

Nested Class Summary
- Nested classes/interfaces inherited from class tech.units.indriya.AbstractSystemOfUnits
  AbstractSystemOfUnits.Helper

Field Summary

Fields
Modifier and Type	Field and Description
`static javax.measure.Unit<javax.measure.quantity.ElectricCurrent>`	`AMPERE` The ampere, symbol A, is the SI unit of electric current.
`static javax.measure.Unit<javax.measure.quantity.Radioactivity>`	`BECQUEREL` The SI unit for activity of a radionuclide (standard name `Bq` ).
`static javax.measure.Unit<javax.measure.quantity.LuminousIntensity>`	`CANDELA` The candela, symbol cd, is the SI unit of luminous intensity in a given direction.
`static javax.measure.Unit<javax.measure.quantity.Temperature>`	`CELSIUS` The SI unit for Celsius temperature (standard name `°C`).
`static javax.measure.Unit<javax.measure.quantity.ElectricCharge>`	`COULOMB` The SI unit for electric charge, quantity of electricity (standard name `C`).
`static javax.measure.Unit<javax.measure.quantity.Volume>`	`CUBIC_METRE` The SI unit for volume quantities (standard name `m3`).
`static javax.measure.Unit<javax.measure.quantity.Time>`	`DAY` A time unit accepted for use with SI units (standard name `d` ).
`static javax.measure.Unit<javax.measure.quantity.ElectricCapacitance>`	`FARAD` The SI unit for capacitance (standard name `F`).
`static javax.measure.Unit<javax.measure.quantity.Mass>`	`GRAM` The SI derived unit for mass quantities (standard name `g`).
`static javax.measure.Unit<javax.measure.quantity.RadiationDoseAbsorbed>`	`GRAY` The SI unit for absorbed dose, specific energy (imparted), kerma (standard name `Gy`).
`static javax.measure.Unit<javax.measure.quantity.ElectricInductance>`	`HENRY` The alternate unit for inductance (standard name `H`).
`static javax.measure.Unit<javax.measure.quantity.Frequency>`	`HERTZ` The SI unit for frequency (standard name `Hz`).
`static javax.measure.Unit<javax.measure.quantity.Time>`	`HOUR` A time unit accepted for use with SI units (standard name `h` ).
`static javax.measure.Unit<javax.measure.quantity.Energy>`	`JOULE` The SI unit for energy, work, quantity of heat (`J`).
`static javax.measure.Unit<javax.measure.quantity.CatalyticActivity>`	`KATAL` The SI unit for catalytic activity (standard name `kat`).
`static javax.measure.Unit<javax.measure.quantity.Temperature>`	`KELVIN` The kelvin, symbol K, is the SI unit of thermodynamic temperature.
`static javax.measure.Unit<javax.measure.quantity.Mass>`	`KILOGRAM` The kilogram, symbol kg, is the SI unit of mass.
`static javax.measure.Unit<javax.measure.quantity.Speed>`	`KILOMETRE_PER_HOUR` A unit of velocity expressing the number of international `kilometres` per `hour` (abbreviation `km/h`).
`static javax.measure.Unit<javax.measure.quantity.Volume>`	`LITRE` A volume unit accepted for use with SI units (standard name `l`).
`static javax.measure.Unit<javax.measure.quantity.LuminousFlux>`	`LUMEN` The SI unit for luminous flux (standard name `lm`).
`static javax.measure.Unit<javax.measure.quantity.Illuminance>`	`LUX` The SI unit for illuminance (standard name `lx`).
`static javax.measure.Unit<javax.measure.quantity.Length>`	`METRE` The metre, symbol m, is the SI unit of length.
`static javax.measure.Unit<javax.measure.quantity.Speed>`	`METRE_PER_SECOND` The SI unit for velocity quantities (standard name `m/s`).
`static javax.measure.Unit<javax.measure.quantity.Acceleration>`	`METRE_PER_SQUARE_SECOND` The SI unit for acceleration quantities (standard name `m/s2` ).
`static javax.measure.Unit<javax.measure.quantity.Time>`	`MINUTE` A time unit accepted for use with SI units (standard name `min`).
`static javax.measure.Unit<javax.measure.quantity.AmountOfSubstance>`	`MOLE` The mole, symbol mol, is the SI unit of amount of substance.
`static javax.measure.Unit<javax.measure.quantity.Time>`	`MONTH` A unit of duration equal to 1/12 `YEAR` (standard name `mo`).
`static javax.measure.Unit<javax.measure.quantity.Force>`	`NEWTON` The SI unit for force (standard name `N`).
`static javax.measure.Unit<javax.measure.quantity.ElectricResistance>`	`OHM` The SI unit for electric resistance (standard name `Ohm`).
`static javax.measure.Unit<javax.measure.quantity.Pressure>`	`PASCAL` The SI unit for pressure, stress (standard name `Pa`).
`static javax.measure.Unit<javax.measure.quantity.Dimensionless>`	`PERCENT` A dimensionless unit accepted for use with SI units (standard name `%`).
`static javax.measure.Unit<javax.measure.quantity.Angle>`	`RADIAN` The SI unit for plane angle quantities (standard name `rad`).
`static javax.measure.Unit<javax.measure.quantity.Time>`	`SECOND` The second, symbol s, is the SI unit of time.
`static javax.measure.Unit<javax.measure.quantity.ElectricConductance>`	`SIEMENS` The SI unit for electric conductance (standard name `S`).
`static javax.measure.Unit<javax.measure.quantity.RadiationDoseEffective>`	`SIEVERT` The SI unit for dose equivalent (standard name `Sv`).
`static javax.measure.Unit<javax.measure.quantity.Area>`	`SQUARE_METRE` The SI unit for area quantities (standard name `m2`).
`static javax.measure.Unit<javax.measure.quantity.SolidAngle>`	`STERADIAN` The SI unit for solid angle quantities (standard name `sr`).
`static javax.measure.Unit<javax.measure.quantity.MagneticFluxDensity>`	`TESLA` The alternate unit for magnetic flux density (standard name `T`).
`static javax.measure.Unit<javax.measure.quantity.ElectricPotential>`	`VOLT` The SI unit for electric potential difference, electromotive force (standard name `V`).
`static javax.measure.Unit<javax.measure.quantity.Power>`	`WATT` The SI unit for power, radiant, flux (standard name `W`).
`static javax.measure.Unit<javax.measure.quantity.MagneticFlux>`	`WEBER` The SI unit for magnetic flux (standard name `Wb`).
`static javax.measure.Unit<javax.measure.quantity.Time>`	`WEEK` A unit of duration equal to 7 `DAY` (standard name `wk`).
`static javax.measure.Unit<javax.measure.quantity.Time>`	`YEAR` A time unit accepted for use with SI units (standard name `y` ).

Fields inherited from class tech.units.indriya.AbstractSystemOfUnits
E, logger, quantityToUnit, units

Constructor Summary

Constructors
Modifier Constructor and Description

protected Units()
Constructor may only be called by subclasses

Constructors
Modifier	Constructor and Description
`protected`	`Units()` Constructor may only be called by subclasses

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static Units`	`getInstance()` Returns the unique instance of this class.
`String`	`getName()`

Methods inherited from class tech.units.indriya.AbstractSystemOfUnits
getUnit, getUnit, getUnit, getUnit, getUnits, getUnits

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - AMPERE
```
public static final javax.measure.Unit<javax.measure.quantity.ElectricCurrent> AMPERE
```
    The ampere, symbol A, is the SI unit of electric current. It is defined by taking the fixed numerical value of the elementary charge e to be 1.602 176 634 × 10⁻¹⁹ when expressed in the unit C, which is equal to A s, where the second is defined in terms of ∆νCs. This definition implies the exact relation e = 1.602 176 634 × 10⁻¹⁹ A s. Inverting this relation gives an exact expression for the unit ampere in terms of the defining constants e and ∆νCs: 1 A = (e / 1.602 176 634 × 10⁻¹⁹) s⁻¹
    
    Implementation Note:
    SI Base Unit
  - CANDELA
```
public static final javax.measure.Unit<javax.measure.quantity.LuminousIntensity> CANDELA
```
    The candela, symbol cd, is the SI unit of luminous intensity in a given direction. It is defined by taking the fixed numerical value of the luminous efficacy of monochromatic radiation of frequency 540 × 10¹² Hz, Kcd, to be 683 when expressed in the unit lm W−1, which is equal to cd sr W⁻¹, or cd sr kg⁻¹ m⁻² s³, where the kilogram, metre and second are defined in terms of h, c and ∆νCs. This definition implies the exact relation Kcd = 683 cd sr kg⁻¹ m⁻² s³ for monochromatic radiation of frequency ν = 540 × 10¹² Hz. Inverting this relation gives an exact expression for the candela in terms of the defining constants Kcd, h and ∆νCs: 1 cd = (Kcd / 683) kg m² s⁻³ sr⁻¹
    
    Implementation Note:
    SI Base Unit
    
    See Also:
    
    Wikipedia: Candela
  - KELVIN
```
public static final javax.measure.Unit<javax.measure.quantity.Temperature> KELVIN
```
    The kelvin, symbol K, is the SI unit of thermodynamic temperature. It is defined by taking the fixed numerical value of the Boltzmann constant k to be 1.380 649 × 10−²³ when expressed in the unit J K⁻¹, which is equal to kg m² s⁻² K⁻¹, where the kilogram, metre and second are defined in terms of h, c and ∆νCs. This definition implies the exact relation k = 1.380 649 × 10⁻²³ kg m² s⁻² K⁻¹. Inverting this relation gives an exact expression for the kelvin in terms of the defining constants k, h and ∆νCs: 1 K = (1.380 649 / k) × 10⁻²³ kg m² s⁻²
    
    Implementation Note:
    SI Base Unit
    
    See Also:
    
    JOULE
  - KILOGRAM
```
public static final javax.measure.Unit<javax.measure.quantity.Mass> KILOGRAM
```
    The kilogram, symbol kg, is the SI unit of mass. It is defined by taking the fixed numerical value of the Planck constant h to be 6.626 070 15 × 10⁻³⁴ when expressed in the unit J s, which is equal to kg m² s−1, where the metre and the second are defined in terms of c and ∆νCs. This definition implies the exact relation h = 6.626 070 15 × 10−34 kg m² s⁻¹. Inverting this relation gives an exact expression for the kilogram in terms of the three defining constants h, ∆νCs and c: 1 kg = (h / 6.626 070 15 × 10⁻³⁴) m⁻² s
    
    Implementation Note:
    SI Base Unit
    
    See Also:
    
    Wikipedia: Kilogram, GRAM, METRE, SECOND
  - METRE
```
public static final javax.measure.Unit<javax.measure.quantity.Length> METRE
```
    The metre, symbol m, is the SI unit of length. It is defined by taking the fixed numerical value of the speed of light in vacuum c to be 299 792 458 when expressed in the unit m s⁻¹, where the second is defined in terms of the caesium frequency ∆νCs. This definition implies the exact relation c = 299 792 458 m s⁻¹. Inverting this relation gives an exact expression for the metre in terms of the defining constants c and ∆νCs: 1 m = (c / 299 792 458)s = 9 192 631 770 c / 299 792 458 ∆νCs ≈ 30.663 319 c / ∆νCs
    
    Implementation Note:
    SI Base Unit
  - MOLE
```
public static final javax.measure.Unit<javax.measure.quantity.AmountOfSubstance> MOLE
```
    The mole, symbol mol, is the SI unit of amount of substance. One mole contains exactly 6.022 140 76 × 10²³ elementary entities. This number is the fixed numerical value of the Avogadro constant, NA, when expressed in the unit mol⁻¹ and is called the Avogadro number. The amount of substance, symbol n, of a system is a measure of the number of specified elementary entities. An elementary entity may be an atom, a molecule, an ion, an electron, any other particle or specified group of particles. This definition implies the exact relation Nₐ = 6.022 140 76 × 10²³ mol⁻¹. Inverting this relation gives an exact expression for the mole in terms of the defining constant NA: 1 mol = 6.02214076 × 10²³ / Nₐ
    
    Implementation Note:
    SI Base Unit
  - SECOND
```
public static final javax.measure.Unit<javax.measure.quantity.Time> SECOND
```
    The second, symbol s, is the SI unit of time. It is defined by taking the fixed numerical value of the caesium frequency ∆νCs, the unperturbed ground-state hyperfine transition frequency of the caesium 133 atom, to be 9 192 631 770 when expressed in the unit Hz, which is equal to s⁻¹. This definition implies the exact relation ∆νCs = 9 192 631 770 Hz. Inverting this relation gives an expression for the unit second in terms of the defining constant ∆νCs: 1 Hz = ∆νCs / 9 192 631 770 or 1 s = 9 192 631 770 / ∆νCs
    
    Implementation Note:
    SI Base Unit
  - GRAM
```
public static final javax.measure.Unit<javax.measure.quantity.Mass> GRAM
```
    The SI derived unit for mass quantities (standard name g). The base unit for mass quantity is KILOGRAM.
  - RADIAN
```
public static final javax.measure.Unit<javax.measure.quantity.Angle> RADIAN
```
    The SI unit for plane angle quantities (standard name rad). One radian is the angle between two radii of a circle such that the length of the arc between them is equal to the radius.
  - STERADIAN
```
public static final javax.measure.Unit<javax.measure.quantity.SolidAngle> STERADIAN
```
    The SI unit for solid angle quantities (standard name sr). One steradian is the solid angle subtended at the center of a sphere by an area on the surface of the sphere that is equal to the radius squared. The total solid angle of a sphere is 4*Pi steradians.
  - HERTZ
```
public static final javax.measure.Unit<javax.measure.quantity.Frequency> HERTZ
```
    The SI unit for frequency (standard name Hz). A unit of frequency equal to one cycle per second. After Heinrich Rudolf Hertz (1857-1894), German physicist who was the first to produce radio waves artificially.
  - NEWTON
```
public static final javax.measure.Unit<javax.measure.quantity.Force> NEWTON
```
    The SI unit for force (standard name N). One newton is the force required to give a mass of 1 kilogram an Force of 1 metre per second per second. It is named after the English mathematician and physicist Sir Isaac Newton (1642-1727).
  - PASCAL
```
public static final javax.measure.Unit<javax.measure.quantity.Pressure> PASCAL
```
    The SI unit for pressure, stress (standard name Pa). One pascal is equal to one newton per square meter. It is named after the French philosopher and mathematician Blaise Pascal (1623-1662).
  - JOULE
```
public static final javax.measure.Unit<javax.measure.quantity.Energy> JOULE
```
    The SI unit for energy, work, quantity of heat (J). One joule is the amount of work done when an applied force of 1 newton moves through a distance of 1 metre in the direction of the force. It is named after the English physicist James Prescott Joule (1818-1889).
  - WATT
```
public static final javax.measure.Unit<javax.measure.quantity.Power> WATT
```
    The SI unit for power, radiant, flux (standard name W). One watt is equal to one joule per second. It is named after the British scientist James Watt (1736-1819).
  - COULOMB
```
public static final javax.measure.Unit<javax.measure.quantity.ElectricCharge> COULOMB
```
    The SI unit for electric charge, quantity of electricity (standard name C). One Coulomb is equal to the quantity of charge transferred in one second by a steady current of one ampere. It is named after the French physicist Charles Augustin de Coulomb (1736-1806).
  - VOLT
```
public static final javax.measure.Unit<javax.measure.quantity.ElectricPotential> VOLT
```
    The SI unit for electric potential difference, electromotive force (standard name V). One Volt is equal to the difference of electric potential between two points on a conducting wire carrying a constant current of one ampere when the power dissipated between the points is one watt. It is named after the Italian physicist Count Alessandro Volta (1745-1827).
  - FARAD
```
public static final javax.measure.Unit<javax.measure.quantity.ElectricCapacitance> FARAD
```
    The SI unit for capacitance (standard name F). One Farad is equal to the capacitance of a capacitor having an equal and opposite charge of 1 coulomb on each plate and a potential difference of 1 volt between the plates. It is named after the British physicist and chemist Michael Faraday (1791-1867).
  - OHM
```
public static final javax.measure.Unit<javax.measure.quantity.ElectricResistance> OHM
```
    The SI unit for electric resistance (standard name Ohm). One Ohm is equal to the resistance of a conductor in which a current of one ampere is produced by a potential of one volt across its terminals. It is named after the German physicist Georg Simon Ohm (1789-1854).
  - SIEMENS
```
public static final javax.measure.Unit<javax.measure.quantity.ElectricConductance> SIEMENS
```
    The SI unit for electric conductance (standard name S). One Siemens is equal to one ampere per volt. It is named after the German engineer Ernst Werner von Siemens (1816-1892).
  - WEBER
```
public static final javax.measure.Unit<javax.measure.quantity.MagneticFlux> WEBER
```
    The SI unit for magnetic flux (standard name Wb). One Weber is equal to the magnetic flux that in linking a circuit of one turn produces in it an electromotive force of one volt as it is uniformly reduced to zero within one second. It is named after the German physicist Wilhelm Eduard Weber (1804-1891).
  - TESLA
```
public static final javax.measure.Unit<javax.measure.quantity.MagneticFluxDensity> TESLA
```
    The alternate unit for magnetic flux density (standard name T). One Tesla is equal equal to one weber per square metre. It is named after the Serbian-born American electrical engineer and physicist Nikola Tesla (1856-1943).
  - HENRY
```
public static final javax.measure.Unit<javax.measure.quantity.ElectricInductance> HENRY
```
    The alternate unit for inductance (standard name H). One Henry is equal to the inductance for which an induced electromotive force of one volt is produced when the current is varied at the rate of one ampere per second. It is named after the American physicist Joseph Henry (1791-1878).
  - CELSIUS
```
public static final javax.measure.Unit<javax.measure.quantity.Temperature> CELSIUS
```
    The SI unit for Celsius temperature (standard name °C). This is a unit of temperature such as the freezing point of water (at one atmosphere of pressure) is 0 °C, while the boiling point is 100 °C.
  - LUMEN
```
public static final javax.measure.Unit<javax.measure.quantity.LuminousFlux> LUMEN
```
    The SI unit for luminous flux (standard name lm). One Lumen is equal to the amount of light given out through a solid angle by a source of one candela intensity radiating equally in all directions.
  - LUX
```
public static final javax.measure.Unit<javax.measure.quantity.Illuminance> LUX
```
    The SI unit for illuminance (standard name lx). One Lux is equal to one lumen per square metre.
  - BECQUEREL
```
public static final javax.measure.Unit<javax.measure.quantity.Radioactivity> BECQUEREL
```
    The SI unit for activity of a radionuclide (standard name Bq ). One becquerel is the radiation caused by one disintegration per second. It is named after the French physicist, Antoine-Henri Becquerel (1852-1908).
  - GRAY
```
public static final javax.measure.Unit<javax.measure.quantity.RadiationDoseAbsorbed> GRAY
```
    The SI unit for absorbed dose, specific energy (imparted), kerma (standard name Gy). One gray is equal to the dose of one joule of energy absorbed per one kilogram of matter. It is named after the British physician L. H. Gray (1905-1965).
  - SIEVERT
```
public static final javax.measure.Unit<javax.measure.quantity.RadiationDoseEffective> SIEVERT
```
    The SI unit for dose equivalent (standard name Sv). One Sievert is equal is equal to the actual dose, in grays, multiplied by a "quality factor" which is larger for more dangerous forms of radiation. It is named after the Swedish physicist Rolf Sievert (1898-1966).
  - KATAL
```
public static final javax.measure.Unit<javax.measure.quantity.CatalyticActivity> KATAL
```
    The SI unit for catalytic activity (standard name kat).
  - METRE_PER_SECOND
```
public static final javax.measure.Unit<javax.measure.quantity.Speed> METRE_PER_SECOND
```
    The SI unit for velocity quantities (standard name m/s).
  - METRE_PER_SQUARE_SECOND
```
public static final javax.measure.Unit<javax.measure.quantity.Acceleration> METRE_PER_SQUARE_SECOND
```
    The SI unit for acceleration quantities (standard name m/s2 ).
  - SQUARE_METRE
```
public static final javax.measure.Unit<javax.measure.quantity.Area> SQUARE_METRE
```
    The SI unit for area quantities (standard name m2).
  - CUBIC_METRE
```
public static final javax.measure.Unit<javax.measure.quantity.Volume> CUBIC_METRE
```
    The SI unit for volume quantities (standard name m3).
  - KILOMETRE_PER_HOUR
```
public static final javax.measure.Unit<javax.measure.quantity.Speed> KILOMETRE_PER_HOUR
```
    A unit of velocity expressing the number of international kilometres per hour (abbreviation km/h).
    
    See Also:
    
    Wikipedia: Kilometres per hour
  - PERCENT
```
public static final javax.measure.Unit<javax.measure.quantity.Dimensionless> PERCENT
```
    A dimensionless unit accepted for use with SI units (standard name %).
  - MINUTE
```
public static final javax.measure.Unit<javax.measure.quantity.Time> MINUTE
```
    A time unit accepted for use with SI units (standard name min).
  - HOUR
```
public static final javax.measure.Unit<javax.measure.quantity.Time> HOUR
```
    A time unit accepted for use with SI units (standard name h ).
  - DAY
```
public static final javax.measure.Unit<javax.measure.quantity.Time> DAY
```
    A time unit accepted for use with SI units (standard name d ).
  - WEEK
```
public static final javax.measure.Unit<javax.measure.quantity.Time> WEEK
```
    A unit of duration equal to 7 DAY (standard name wk).
  - YEAR
```
public static final javax.measure.Unit<javax.measure.quantity.Time> YEAR
```
    A time unit accepted for use with SI units (standard name y ).
  - MONTH
```
public static final javax.measure.Unit<javax.measure.quantity.Time> MONTH
```
    A unit of duration equal to 1/12 YEAR (standard name mo).
    
    Since:
    
    2.3
  - LITRE
```
public static final javax.measure.Unit<javax.measure.quantity.Volume> LITRE
```
    A volume unit accepted for use with SI units (standard name l).
    
    See Also:
    
    Wikipedia: Litre
- Constructor Detail
  - Units
```
protected Units()
```
    Constructor may only be called by subclasses
- Method Detail
  - getName
```
public String getName()
```
    Specified by:
    
    getName in interface javax.measure.spi.SystemOfUnits
    
    Specified by:
    
    getName in interface tech.uom.lib.common.function.Nameable
    
    Specified by:
    
    getName in class AbstractSystemOfUnits
  - getInstance
```
public static Units getInstance()
```
    Returns the unique instance of this class.
    
    Returns:
    
    the Units instance.

Class Units

Nested Class Summary

Nested classes/interfaces inherited from class tech.units.indriya.AbstractSystemOfUnits

Field Summary

Fields inherited from class tech.units.indriya.AbstractSystemOfUnits

Constructor Summary

Method Summary

Methods inherited from class tech.units.indriya.AbstractSystemOfUnits

Methods inherited from class java.lang.Object

Field Detail

AMPERE

CANDELA

KELVIN

KILOGRAM

METRE

MOLE

SECOND

GRAM

RADIAN

STERADIAN

HERTZ

NEWTON

PASCAL

JOULE

WATT

COULOMB

VOLT

FARAD

OHM

SIEMENS

WEBER

TESLA

HENRY

CELSIUS

LUMEN

LUX

BECQUEREL

GRAY

SIEVERT

KATAL

METRE_PER_SECOND

METRE_PER_SQUARE_SECOND

SQUARE_METRE

CUBIC_METRE

KILOMETRE_PER_HOUR

PERCENT

MINUTE

HOUR

DAY

WEEK

YEAR

MONTH

LITRE

Constructor Detail

Units

Method Detail

getName

getInstance