formatBinaryFixedPoint

function formatBinaryFixedPoint(formatter, value): string;

Formats a BinaryFixedPoint using a user-supplied Intl.NumberFormat instance, preserving full precision regardless of the value's magnitude.

Internally calls binaryFixedPointToBase10 and forwards the resulting integer to formatter.format using ES2023 string scientific notation ("<raw>E-<decimals>"). This preserves precision in fully-compliant runtimes and bypasses the JavaScript number mantissa limit.

Use this when you want locale-aware output, currency formatting, grouping separators, or rounding modes from the rich Intl.NumberFormat API. Prefer binaryFixedPointToString when portability across older runtimes (older Hermes/React Native, etc.) is a concern.

Parameters

ParameterType
formatterNumberFormat
valueBinaryFixedPoint<Signedness, number, number>

Returns

string

Example

const q1_15 = binaryFixedPoint('signed', 16, 15);
const formatter = new Intl.NumberFormat('fr-FR', {
    maximumFractionDigits: 4,
});
formatBinaryFixedPoint(formatter, q1_15('0.1')); // "0,1"

See

On this page