diff --git a/content/en/docs/refguide/modeling/data-types.md b/content/en/docs/refguide/modeling/data-types.md index 58a8ab11df8..c859a1eed69 100644 --- a/content/en/docs/refguide/modeling/data-types.md +++ b/content/en/docs/refguide/modeling/data-types.md @@ -19,7 +19,7 @@ Mendix supports the following data types: | Boolean | A truth value. | `true` and `false` | | Binary | Binary data such as files and images. | | | Date and time | A point in time consisting of a date and a time component accurate up to milliseconds. | Thursday, 12 February 2015, 14:50:36 | -| Decimal | A high-precision fractional number. The Decimal type can be used for high-precision calculations. Use this type to represent amounts of money for example. A Decimal can have up to 20 digits before the decimal point, and up to 8 after. | 3.14, 738000000000.00000001 | +| Decimal | A high-precision fractional number. The Decimal type can be used for high-precision calculations. Use this type to represent amounts of money for example. A Decimal can have up to 20 digits before the decimal point, and, from Mendix 11.6.0, is configurable between 8 up to 18 after. In versions below 11.6, a Decimal can only have up to 8 digits after the decimal point. | 3.14, 738000000000.00000001 | | Enumeration | One of the values of the given [enumeration](/refguide/enumerations/). | Red, Green, Blue; Todo, Running, Done | | Integer/Long | A whole number between -(2^63) and 2^63 - 1. The attribute types AutoNumber, Integer and Long map to this data type. | -42, 0, 123 | | List | A list of objects of a specific [entity](/refguide/entities/). | | @@ -30,3 +30,17 @@ Mendix supports the following data types: If you want to change data from one type to another (for example, to display a number as part of a message in a text box) you will usually need to use an expression to do this. See [Expressions](/refguide/expressions/) for more information on what is available. An exception is converting an Integer/Long to a Decimal, where conversion is done implicitly if you provide an Integer/Long where a Decimal is expected. + +## Configurable Decimal Scale {#configurable-decimal-scale} + +{{% alert color="info" %}} +Decimal scale is configurable in Mendix version 11.6.0 and above. +{{% /alert %}} + +As mentioned above, the scale of a decimal is configurable between the values of 8 and 18, where precision will always be scale + 20. The setting under `App Settings` will apply to the entire application. + +{{< figure src="/attachments/refguide/modeling/data-types/decimal-scale-setting.png" >}} + +When you adjust the scale of a decimal precision, you will also need to adjust usages of the decimal in frontend elements such as datagrids to respond to the changes. By default, frontend components format decimals with a fixed scale of 2. When specifying `fixed` formatting, the UI will display the value rounded or padded to fit into the fixed format. For example, `1.2345` will result in `1.23` when selecting 2 and `1.23450` when selecting 5. When `Auto` formatting is specified, the UI will display the value as it is stored. + +{{< figure src="/attachments/refguide/modeling/data-types/decimal-scale-formatting.png" >}} diff --git a/static/attachments/refguide/modeling/data-types/decimal-scale-formatting.png b/static/attachments/refguide/modeling/data-types/decimal-scale-formatting.png new file mode 100644 index 00000000000..1f89ae11c6a Binary files /dev/null and b/static/attachments/refguide/modeling/data-types/decimal-scale-formatting.png differ diff --git a/static/attachments/refguide/modeling/data-types/decimal-scale-setting.png b/static/attachments/refguide/modeling/data-types/decimal-scale-setting.png new file mode 100644 index 00000000000..5874d28f2c6 Binary files /dev/null and b/static/attachments/refguide/modeling/data-types/decimal-scale-setting.png differ