---
alias: operation-guide-cultureformatoverride
description: "Customize number, currency, and date formatting through a configuration file override"
---

# Culture Formats Override

Override the current culture formatter configuration by adding key-value pairs under `general.formatter` in the `config.json` file. This configuration is intended for application administrators and isn't available as a user preference in the Critical Manufacturing MES GUI.

## Configuration

* **currency** - Specific overrides to format the currency numeric values.
    * **symbol** (string) - Currency symbol to use (note: since this could be also defined in `/Cmf/Guis/Configuration/CurrencyFormat/Symbol` that config has precedence over the one in config.json; if non defined, defaults to the current culture symbol)
    * **decimalPlaces** (number) - Currency fixed number of decimal places to use (note: since this could be also defined in `/Cmf/Guis/Configuration/CurrencyFormat/DecimalPlaces/` that config has precedence over the one in config.json; if non defined, defaults to the current culture currency decimal places)
* **number** - Overrides to format any numeric values.
    * **decimalPlaces** (number) - Maximum number of decimal places that a number can display (currency numeric values not affected) (defaults to current culture decimal places if not defined)
    * **thousandSeparator** (string) - String to separate thousand groupings. (defaults to current culture separator if not defined)
    * **decimalSeparator** (string)  - String to separate the decimal part in a number (defaults to current culture separator if not defined)
* **datetime** - Overrides the formatting of date and time values.
    * **date** (string) - Date format. The default value is the date format of the current culture. For the supported values, see [Supported Date Formats](#supported-date-formats).
    * **time** (string) - Time format  (defaults to current culture). Supported formats:
        * `HH:mm`
        * `hh:mm A`
        * `HH:mm:ss`
        * `hh:mm:ss A`
    * **firstDayOfWeek** (string) - First day of week (defaults to current culture).
    Supported formats:
        * `Sunday`
        * `Monday`
        * `Tuesday`
        * `Wednesday`
        * `Thursday`
        * `Friday`
        * `Saturday`

### Supported Date Formats

Set `general.formatter.datetime.date` to one of the following values. The examples that contain month names use the `en-US` culture.

| Format | Example |
| --- | --- |
| `DD/MM/YYYY` | `29/09/2026` |
| `MM/DD/YYYY` | `09/29/2026` |
| `DD/MM` | `29/09` |
| `MM/DD` | `09/29` |
| `DD.MM.YYYY` | `29.09.2026` |
| `YYYY/MM/DD` | `2026/09/29` |
| `DD MMM YYYY` | `29 Sep 2026` |
| `DD MMMM YYYY` | `29 September 2026` |
| `MMM DD YYYY` | `Sep 29 2026` |
| `MMMM DD YYYY` | `September 29 2026` |

Table: Supported date formats

`MMM` represents an abbreviated month name, and `MMMM` represents a full month name.

## Configuration Example

The following example overrides the currency, number, and date and time formatting:

```json
{
    "general": {
        "supportedCultures": [
            "en-US",
            "pt-PT",
            "de-DE",
            "vi-VN",
            "zh-CN",
            "zh-TW",
            "es-ES",
            "pl-PL"
        ],
        "formatter": {
            "currency": {
                "symbol": "@",
                "decimalPlaces": 2
            },
            "number": {
                "decimalPlaces": 5,
                "thousandSeparator": " ",
                "decimalSeparator": ","
            },
            "datetime": {
                "date": "DD MMMM YYYY",
                "time": "HH:mm:ss",
                "firstDayOfWeek": "Monday"
            }
        },
        "supportedThemes": [
            "cmf.style.light"
        ]
    }
}
```

With this configuration, dates are displayed as shown in the following image:

![Screenshot showing an example of the date format, with the day followed by the full month name and the year.](images/date_format_full_month_name.png)

!!! note
    Date formats with textual month names are supported for value display. After you select a date through the Date Time Picker, the input uses a numeric month: day-first formats use `DD/MM/YYYY`, and month-first formats use `MM/DD/YYYY`.