Skip to content

Enumerate short unit identifier sources #40

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
eemeli wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Enumerate short unit identifier sources #40

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -167,8 +167,15 @@ the output is determined by the `unitDisplay` option:

The "long unit identifier" is the `unit` option value.
The "short unit identifier" is a locale-independent string derived from the `unit` option value
which will need to be explicitly defined from SI units and otherwise,
with e.g. `l` for `litre` and `TB` for `terabyte`.
with e.g. `L` for `liter` and `TB` for `terabyte`.
The short unit identifiers are sourced from the following external authorities (in preference order):
- The International System of Units (the default authority, for all available units)
- ISO 8601-1:2019 Date and time — Representations for information interchange (`month`, `week`, `year`)
- ISO 80000 Quantities and units (`fahrenheit`, `bit`, `byte`, and the prefixed variants of the latter two)
- NIST Handbook 44 (US customary units)
- The Swedish Dictionary published by the Swedish Academy (`mile-scandinavian`)
- Oxford English Dictionary (`stone`)

Compound units are formed by replacing the `-per-` with a solidus `/` (U+002F)
and by mapping the unit parts separately to their short unit identifiers.

Expand Down