DEC2HEX

What it does

DEC2HEX(number, [places])

DEC2HEX(number, [places]) converts decimal to hexadecimal. The result is text, with optional leading zeros controlled by places.

Try it

=DEC2HEX(45,4) returns "002D". All of these represent the same integer: decimal 45, binary 101101, octal 55, and hexadecimal 2D.

For a negative value, =DEC2HEX(-45,4) returns "FFFFFFFFD3". Encode 2^40-45=1099511627731 in hexadecimal. The sign representation occupies ten digits even though places is four.

Quirks

These engineering conversions use signed fixed-width encodings, not arbitrary-length integers. The destination’s numeric range is -549,755,813,888 through 549,755,813,887. The decimal input is truncated toward zero. For a positive result a width too small gives #NUM!. A negative result uses ten digits; the current code still validates an explicitly supplied width before emitting it, despite documentation describing the width as ignored.

How to implement

Separate input parsing, signed interpretation and output formatting. Coerce the decimal number and truncate it toward zero to obtain integer v. Check v against the 40-bit signed target range. If negative, encode 2^40+v in base 16 using ten digits. Otherwise use repeated division by 16, reverse the remainders and left-pad to the requested width. Truncate the width and validate it in the current supported range one through ten. Return text; a decimal number formatted to look similar is a different value kind.

Rust code

5 dec2hex "DEC2HEX" (1, 2) [V "number", V "places"] |s, a, sv| { from_decimal(s, a, radix::dec2hex_kernel) }

pub fn dec2hex_kernel(number: f64, places: Option<f64>) -> Result<ExcelText, WorksheetErrorCode> {
    dec_to_target_kernel(number, places, HEX_SPEC)
}

No implementation has been published with a Handbook test suite for this function.

Version differences

The recorded environments below distinguish a reading from a same-input comparison. Counts describe captured inputs in each environment; overlapping captures and comparisons are not totals of unique worksheet calls.

The record contains no same-input comparison between these environments. Reading different inputs on different builds does not establish either a version change or cross-build agreement.

Recorded environments and comparison details.

Alternatives

HEX2DEC converts in the reverse direction. BASE and DECIMAL provide general radix conversion with different sign rules. A full-width negative engineering encoding is not a minus-prefixed numeral; choose the pair whose sign convention fits your input.

Named variants

No named variants are recorded yet.