UnitConversions Variable @beta

One-stop unit conversion helpers for the built-in canonical unit set generated from @bentley/units-schema. This surface is synchronous and only supports built-in canonical unit names shipped with core-quantity. getConversion(...) returns UnitConversionProps and uses error: true as the compatibility sentinel for known-but-incompatible built-in units. convert(...) and convertValue(...) are the throwing application helpers to use when invalid conversion metadata should fail fast. isCompatible(...) is the explicit built-in compatibility check to use before applying a conversion when a non-throwing branch is preferred. For schema-defined, custom, or provider-resolved units outside that built-in set, use a UnitsProvider-based workflow instead.

Type

{ convert: (fromUnit: UnitName, toUnit: UnitName, value: number) => number, convertValue: (value: number, conversion: UnitConversionProps) => number, getConversion: (fromUnit: UnitName, toUnit: UnitName) => UnitConversionProps, isCompatible: (fromUnit: UnitName, toUnit: UnitName) => boolean }

Default Value

...``` ### Defined in - <span class="defined-in"><a href="https://github.com/iTwin/itwinjs-core/blob/79af2cbc254787b2f6acb7ab8f06855f52f873de/core/quantity/src/UnitConversions.ts#L149" target="_blank">quantity/src/UnitConversions.ts</a></span> Line 149

Last Updated: 27 May, 2026