Decimal: #(decimal("0.1") + decimal("0.2")) \\\nFloat: #(0.1 + 0.2)\n![\"Preview\"](\"/en-US-v0.14.1/assets/5b7d4abe1e81bdf2204e021eab6b8811.png\")
A fixed-point decimal number type.
\nThis type should be used for precise arithmetic operations on numbers\nrepresented in base 10. A typical use case is representing currency.
\nDecimal: #(decimal("0.1") + decimal("0.2")) \\\nFloat: #(0.1 + 0.2)\nTo create a decimal number, use the decimal(string) constructor, such as\nin decimal("3.141592653") (note the double quotes!). This\nconstructor preserves all given fractional digits, provided they are\nrepresentable as per the limits specified below (otherwise, an error is\nraised).
You can also convert any integer to a decimal with the\ndecimal(int) constructor, e.g. decimal(59). However, note that\nconstructing a decimal from a floating-point number, while\nsupported, is an imprecise conversion and therefore discouraged. A\nwarning will be raised if Typst detects that there was an accidental float\nto decimal cast through its constructor, e.g. if writing decimal(3.14)\n(note the lack of double quotes, indicating this is an accidental float\ncast and therefore imprecise). It is recommended to use strings for\nconstant decimal values instead (e.g. decimal("3.14")).
The precision of a float to decimal cast can be slightly improved by\nrounding the result to 15 digits with calc.round, but there are still no\nprecision guarantees for that kind of conversion.
Basic arithmetic operations are supported on two decimals and on pairs of\ndecimals and integers.
\nBuilt-in operations between float and decimal are not supported in order\nto guard against accidental loss of precision. They will raise an error\ninstead.
Certain calc functions, such as trigonometric functions and power between\ntwo real numbers, are also only supported for float (although raising\ndecimal to integer exponents is supported). You can opt into potentially\nimprecise operations with the float(decimal) constructor, which casts\nthe decimal number into a float, allowing for operations without\nprecision guarantees.
To display a decimal, simply insert the value into the document. To only\ndisplay a certain number of digits, round the decimal first.\nLocalized formatting of decimals and other numbers is not yet supported, but\nplanned for the future.
\nYou can convert decimals to strings using the str constructor. This way,\nyou can post-process the displayed representation, e.g. to replace the\nperiod with a comma (as a stand-in for proper built-in localization to\nlanguages that use the comma).
A decimal number has a limit of 28 to 29 significant base-10 digits. This\nincludes the sum of digits before and after the decimal point. As such,\nnumbers with more fractional digits have a smaller range. The maximum and\nminimum decimal numbers have a value of 79228162514264337593543950335\nand -79228162514264337593543950335 respectively. In contrast with\nfloat, this type does not support infinity or NaN, so overflowing or\nunderflowing operations will raise an error.
Typical operations between decimal numbers, such as addition,\nmultiplication, and power to an integer, will be highly precise\ndue to their fixed-point representation. Note, however, that multiplication\nand division may not preserve all digits in some edge cases: while they are\nconsidered precise, digits past the limits specified above are rounded off\nand lost, so some loss of precision beyond the maximum representable digits\nis possible. Note that this behavior can be observed not only when dividing,\nbut also when multiplying by numbers between 0 and 1, as both operations can\npush a number's fractional digits beyond the limits described above, leading\nto rounding. When those two operations do not surpass the digit limits, they\nare fully precise.
Converts a value to a decimal.
It is recommended to use a string to construct the decimal number, or an\ninteger (if desired). The string must contain a number in the\nformat "3.14159" (or "-3.141519" for negative numbers). The\nfractional digits are fully preserved; if that's not possible due to the\nlimit of significant digits (around 28 to 29) having been reached, an\nerror is raised as the given decimal number wouldn't be representable.
While this constructor can be used with floating-point numbers\nto cast them to decimal, doing so is discouraged as this cast is\ninherently imprecise. It is easy to accidentally perform this cast by\nwriting decimal(1.234) (note the lack of double quotes), which is\nwhy Typst will emit a warning in that case. Please write\ndecimal("1.234") instead for that particular case (initialization of\na constant decimal). Also note that floats that are NaN or infinite\ncannot be cast to decimals and will raise an error.
#decimal("1.222222222222222")\n![\"Preview\"](\"/en-US-v0.14.1/assets/45faa507ce50e6521579e6c9abb4659a.png\")
The value that should be converted to a decimal.
"}],"types":["bool","int","float","str","decimal"],"strings":[],"default":null,"positional":true,"named":false,"required":true,"variadic":false,"settable":false}],"returns":["decimal"],"scope":[]},"scope":[]}}}