Unit Preferences provide a way to get the units that are appropriate for a region, and usage, and threshold amounts. The Unit Conversions are used to handle conversion of units needed to use the preferences.This release adds additional structure for usage and threshold amount, allowing for more additions of regions, usages, thresholds, and units in future releases.
- The Base Unit shows the unit whose amount is to be compared to the ‘If ≥’ amount of the Result Unit.
- The unit identifiers are internal, and would be localized for display to users. See Hectare, for example.
- The Usage shows the type of usage; default is used as a fallback no more specific match is found.
- The Sample region represents a set of regions if it has a superscript. See the table at the bottom. 001 (World) is the default if no more specific region is found.
- The ‘If ≥’ column shows the thresholds: the first line for a given region where the input amount is greater or equal applies. For example, for 0.5km as input for [area, default, 001] would result in hectare.
- Each numeric value is an exact rational. (Radians are an exception since the value of π is irrational; a rational approximation is used.)The format is a terminating decimal where possible; otherwise a repeating decimal if possible (where ˙ marks the start of the reptend); otherwise a rational number (of the form numerator/denominator).
- The units are grouped and ordered by Quantity (which are based on the NIST quantities, see NIST 811). Note that the quantities are informative.
- The LDML specification should be consulted for more details, such as how to handle complex units (such as foot-per-minute) by converting the elements, and how to fall back if a given usage or region is not found.
Warning: Do not scrape this chart for production data.
Instead, for the meaning of the fields and data consult the LDML specification, and for machine-readable source data, access common/supplemental/units.xml, and for test data, access common/testData/units/unitPreferencesTest.txt.
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
square-meter |
default |
001 |
1 |
square-kilometer |
|
area |
hectare |
square-meter |
square-centimeter |
GB, …1 |
square-mile |
acre |
square-foot |
square-inch |
floor |
001 |
square-meter |
CA, …1 |
square-foot |
geograph |
001 |
square-kilometer |
GB, …1 |
square-mile |
land |
001 |
hectare |
GB, …1 |
acre |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
item-per-cubic-meter |
blood-glucose |
AG, …1 |
1 |
millimole-per-liter |
|
concentration |
001 |
milligram-ofglucose-per-deciliter |
default |
item-per-cubic-meter |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
cubic-meter-per-meter |
default |
001 |
1 |
liter-per-100-kilometer |
|
consumption |
vehicle-fuel |
BR, …1 |
liter-per-kilometer |
US |
mile-per-gallon |
CA, …2 |
mile-per-gallon-imperial |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
second |
default |
001 |
1 |
day |
|
duration |
hour |
minute |
second |
millisecond |
microsecond |
nanosecond |
media |
minute & second |
second |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
kilogram-square-meter-per-square-second |
default |
001 |
1 |
kilowatt-hour |
|
energy |
food |
US |
foodcalorie |
001 |
kilocalorie |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
meter |
default |
001 |
1 |
kilometer |
|
length |
meter |
centimeter |
GB, …1 |
mile |
foot |
inch |
focal-length |
001 |
millimeter |
person |
centimeter |
CA, …3 |
inch |
person-height |
001 |
centimeter |
CA, …3 |
3 |
foot & inch |
1 |
inch |
AT, …1 |
meter & centimeter |
rainfall |
BR |
centimeter |
US |
inch |
001 |
millimeter |
road |
0.9 |
kilometer |
300 |
meter |
precision-increment/50 |
10 |
precision-increment/10 |
1 |
precision-increment/1 |
US |
0.5 |
mile |
|
100 |
foot |
precision-increment/50 |
10 |
precision-increment/10 |
1 |
precision-increment/1 |
GB |
0.5 |
mile |
|
100 |
yard |
precision-increment/50 |
10 |
precision-increment/10 |
1 |
precision-increment/1 |
SE |
mile-scandinavian |
|
kilometer |
300 |
meter |
precision-increment/50 |
10 |
precision-increment/10 |
1 |
precision-increment/1 |
snowfall |
001 |
centimeter |
|
US |
inch |
vehicle |
GB, …1 |
foot & inch |
001 |
meter |
visiblty |
0.1 |
kilometer |
1 |
meter |
DE, …1 |
GB, …1 |
mile |
foot |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
kilogram |
default |
001 |
1 |
tonne |
|
mass |
kilogram |
gram |
milligram |
microgram |
GB, …1 |
ton |
pound |
ounce |
person |
001 |
kilogram |
gram |
US |
pound |
pound & ounce |
GB |
stone & pound |
pound & ounce |
HK |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
kilogram-per-cubic-meter |
default |
001 |
1 |
kilogram-per-cubic-meter |
|
mass-density |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
kilogram-square-meter-per-cubic-second |
default |
001 |
1 |
gigawatt |
|
power |
megawatt |
kilowatt |
watt |
milliwatt |
engine |
kilowatt |
GB, …1 |
horsepower |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
kilogram-per-meter-square-second |
baromtrc |
001 |
1 |
hectopascal |
|
pressure |
US |
inch-ofhg |
BR, …2 |
millibar |
MX, …1 |
millimeter-ofhg |
default |
001 |
megapascal |
pascal |
GB, …1 |
pound-force-per-square-inch |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
meter-per-second |
default |
001 |
1 |
kilometer-per-hour |
|
speed |
GB, …1 |
mile-per-hour |
rainfall |
001 |
millimeter-per-hour |
BR |
centimeter-per-hour |
US |
inch-per-hour |
snowfall |
001 |
centimeter-per-hour |
US |
inch-per-hour |
wind |
001 |
kilometer-per-hour |
CN, …1 |
meter-per-second |
GB, …1 |
mile-per-hour |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
kelvin |
default |
001 |
1 |
celsius |
|
temperature |
US |
fahrenheit |
weather |
001 |
celsius |
BS, …1 |
fahrenheit |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
cubic-meter |
default |
001 |
1 |
cubic-meter |
|
volume |
cubic-centimeter |
GB, …1 |
cubic-foot |
cubic-inch |
fluid |
001 |
liter |
milliliter |
US |
gallon |
quart |
pint |
cup |
fluid-ounce |
tablespoon |
teaspoon |
GB |
gallon-imperial |
fluid-ounce-imperial |
oil |
001 |
barrel |
vehicle |
US |
gallon |
001 |
liter |
Base Unit |
Usage |
Sample Region |
If ≥ |
Result Unit |
Skeleton |
Quantity |
year |
default |
001 |
1 |
year |
|
year-duration |
month |
person-age |
2.5 |
year-person |
1 |
year-person & month-person |
month-person |
Region Sets
Sample Region |
Region Set |
AG, …1 |
AG, AI, AO, AU, BA, BG, BH, BM, BN, BW, BY, CA, CH, CM, CN, CZ, DK, DM, EE, FI, FJ, GB, GD, HK, HR, HU, IE, IM, IS, KE, KN, KW, KZ, LC, LI, LT, LU, LV, ME, MG, MK, MO, MS, MT, MU, MY, MZ, NA, NL, NO, NZ, OM, PG, RS, RU, SE, SG, SI, SK, TC, TO, UA, UG, VC, VG, VN, VU, ZA |
AT, …1 |
AT, BE, DZ, EG, ES, FR, HK, ID, IL, IT, JO, MY, SA, SE, TR, VN |
BR, …1 |
BR, IT, JP, KR, MX, MY, NL, TH, TR |
BR, …2 |
BR, EG, GB, IL, TH |
BS, …1 |
BS, BZ, KY, PR, PW, US |
CA, …1 |
CA, GB, MM, US |
CA, …2 |
CA, GB |
CA, …3 |
CA, GB, IN, US |
CN, …1 |
CN, DK, FI, JP, KR, NO, PL, RU, SE |
DE, …1 |
DE, NL |
GB, …1 |
GB, US |
MX, …1 |
MX, RU |