JSPM

const-uom

1.0.2
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 5
  • Score
    100M100P100Q46301F
  • License MIT

Utility library with constants of units of measurements

Package Exports

  • const-uom/information.base10.d.ts
  • const-uom/information.base10.js
  • const-uom/information.base2.d.ts
  • const-uom/information.base2.js
  • const-uom/length.metric.d.ts
  • const-uom/length.metric.js
  • const-uom/time.js.d.ts
  • const-uom/time.js.js
  • const-uom/time.si.d.ts
  • const-uom/time.si.js

Readme

Small utility library with generated constants of units of measurements and their relative values.
No magic, no smart conversions. Just precomputed constants.

Usage

To use this package you'll have to make up your mind with base system you will be working in. E.g. in SI base unit of time is seconds, but in JS milliseconds usually used for different API's (setTimeout classic).

To fullfill this needs, library exposes some units in different bases. In library terms that means which unit will be set to 1 based on which the rest are defined.

Name Import path Base Scaling
Time JavaScript base time.js.js Millisecond = 1 Normal time units scaling
Time SI base time.si.js Second = 1 Normal time units scaling
Information base 10 information.base10.js Byte = 1 SI Kilo = 1000
Information base 2 information.base2.js Byte = 1 Kibi = 1024
Length metric length.metric.js Meter = 1 SI Kilo = 1000

Examples

Time

import { Second, s, MillisecondsInSecond } from "const-uom/time.js.js";

// 10 Seconds in Milliseconds
const ms1 = 10 * Second;
const ms2 = 10 * s;
const ms3 = 10 * MillisecondsInSecond;

// 10000 Milliseconds in Seconds 
const s1 = 10000 / Second; 
const s2 = 10000 / s;
const s3 = 10000 / MillisecondsInSecond;

Information

import { Kibibyte, KiB, KibibytesInByte } from "const-uom/information.base2.js";

// 10 Kibibytes in Bytes
const byte1 = 10 * Kibibyte;
const byte2 = 10 * KiB;
const byte3 = 10 * KibibytesInByte;

// 10240 Bytes in Kibibytes 
const kb1 = 10240 / Kibibyte; 
const kb2 = 10240 / KiB;
const kb3 = 10240 / KibibytesInByte;