cat / 012
clone

a spreadsheet for the terminal: lotus 1-2-3 looks, google sheets keys and formulas, one go binary

cat/module-path
012 / docs / sheets / locale.md
locale.md 6.0K rendered
1---2title: "Locale"3sidebar_position: 124---56# Locale78A file's locale says how its numbers, dates, currency and formulas are9typed and shown, as File > Settings > Locale does in Google Sheets. In10German (Germany) a sheet shows `1.234,56 €` and `26.9.2026`, takes11`1,5` as a number, and formulas separate their arguments with `;`:12`=ROUND(A1*1,19; 2)`.1314![A sheet in German (Germany)](../media/locale-de.png)1516## Choosing one1718File > Settings > Locale lists the locales with a sample of each; type19a language, country or tag to narrow it, Enter picks. The first entry,20Default, follows the [`locale` setting](../reference/config.md#locale),21which new sheets use and which reads `LC_ALL`, `LC_NUMERIC` or `LANG`22(`de_DE.UTF-8`) when nothing sets it. A locale picked here is saved in23the file, marks it modified and undoes with Ctrl+Z.2425| Tag | Locale | Number | Date | Currency |26|---|---|---|---|---|27| `en-US` | English (United States) | 1,234.56 | 9/26/2026 | $1,234.56 |28| `en-GB` | English (United Kingdom) | 1,234.56 | 26/9/2026 | £1,234.56 |29| `en-CA` | English (Canada) | 1,234.56 | 2026-09-26 | $1,234.56 |30| `en-AU` | English (Australia) | 1,234.56 | 26/9/2026 | $1,234.56 |31| `de-DE` | German (Germany) | 1.234,56 | 26.9.2026 | 1.234,56 € |32| `de-CH` | German (Switzerland) | 1’234.56 | 26.9.2026 | CHF 1’234.56 |33| `fr-FR` | French (France) | 1 234,56 | 26/9/2026 | 1 234,56 € |34| `fr-CA` | French (Canada) | 1 234,56 | 2026-09-26 | 1 234,56 $ |35| `es-ES` | Spanish (Spain) | 1.234,56 | 26/9/2026 | 1.234,56 € |36| `es-MX` | Spanish (Mexico) | 1,234.56 | 26/9/2026 | $1,234.56 |37| `it-IT` | Italian (Italy) | 1.234,56 | 26/9/2026 | 1.234,56 € |38| `pt-BR` | Portuguese (Brazil) | 1.234,56 | 26/9/2026 | R$ 1.234,56 |39| `pt-PT` | Portuguese (Portugal) | 1 234,56 | 26/9/2026 | 1 234,56 € |40| `nl-NL` | Dutch (Netherlands) | 1.234,56 | 26-9-2026 | € 1.234,56 |41| `sv-SE` | Swedish (Sweden) | 1 234,56 | 2026-09-26 | 1 234,56 kr |42| `da-DK` | Danish (Denmark) | 1.234,56 | 26.9.2026 | 1.234,56 kr. |43| `nb-NO` | Norwegian (Norway) | 1 234,56 | 26.9.2026 | kr 1 234,56 |44| `fi-FI` | Finnish (Finland) | 1 234,56 | 26.9.2026 | 1 234,56 € |45| `pl-PL` | Polish (Poland) | 1 234,56 | 26.9.2026 | 1 234,56 zł |46| `cs-CZ` | Czech (Czechia) | 1 234,56 | 26.9.2026 | 1 234,56 Kč |47| `ru-RU` | Russian (Russia) | 1 234,56 | 26.9.2026 | 1 234,56 ₽ |48| `tr-TR` | Turkish (Türkiye) | 1.234,56 | 26.9.2026 | ₺1.234,56 |49| `ja-JP` | Japanese (Japan) | 1,234.56 | 2026/9/26 | ¥1,234.56 |50| `zh-CN` | Chinese (China) | 1,234.56 | 2026/9/26 | ¥1,234.56 |5152Dates show day and month without leading zeros, as en-US's do, so most53fit a default column; ISO dates keep theirs. Spaces in numbers are54no-break spaces, so a number never breaks across lines; when typing55one, an ordinary space does.5657## What follows the locale5859- **Typing.** Numbers, percentages, currency and dates are read the60 locale's way: `1.234,5`, `12,5 %`, `12,50 €` and `26.09.2026` in61 German. A date of numbers follows the locale's order (day first in62 most of Europe, year first in Japan and Sweden); `2026-09-26`, month63 names in English (`26 Sep 2026`) and times (`14:30`) read the same64 everywhere. What isn't a value in the locale stays text: `$5` is text65 in German, `9/26/2026` in British English.66- **Showing.** Automatic and every number format use the locale's67 decimal and thousands separators. Currency, Date, Time and Date time68 (Format > Number) show the locale's symbol and order; a69 [custom format](formatting.md) keeps its own symbols and order, only70 its separators follow the locale, as in Sheets.71- **Month and day names.** `mmm`, `mmmm`, `ddd` and `dddd` in a format72 show the locale's language (`Sa 26. September` in German), in the73 form a date with its day takes where the language has one (Polish74 `26 września 2026`, but `wrzesień 2026`); `AM/PM` shows 午前 and 午後75 in Japanese and 上午 and 下午 in Chinese. A format tagged with a76 locale as Excel writes them (`[$-407]mmmm`) shows that locale's77 names. Dates typed with the locale's month names (`26. Okt. 2026`)78 are read as dates too.79- **Formulas.** Where the decimal separator is a comma, arguments are80 separated by `;` and the values of an array's row by `\`: `=IF(A1>1,5;81 "yes"; "no")`, `={1\2;3\4}`. Function names stay in English, as in82 Sheets. The formula bar, editing a cell and the function hints83 (`ROUND(value; [places])`) all use the locale's form, as do formulas84 in [conditional formatting, data validation](rules.md) and filter85 conditions. A formula that doesn't parse says so in the locale's86 syntax: `Expected ; or ) in ROUND`.87- **Filters and text conditions.** A filter's list of values shows them88 as the sheet does (`1.234,50`), and conditions on text (contains,89 starts with, is exactly) test the text the locale shows, in filters90 and conditional formats alike, so their values are kept as typed.91- **The clipboard and CSV files.** Copying writes numbers with the92 locale's decimal separator and pasting reads text the locale's way.93 CSV files are [read and written](../files/README.md) in the locale94 too.95- **The status line.** Sum and Avg of the selection.9697## What doesn't9899The file stores everything the same way in every locale, so a sheet100opens with the same values wherever it's opened: entries as typed in101en-US (`1,234.5`, `09/26/2026`, `=ROUND(A1*1.19, 2)`; see102[the file format](../files/format.md)). Switching the locale redraws103the sheet and changes no value. Functions compute the same everywhere104too: `VALUE("1,5")` and `TEXT(A1, "0.00")` read and write en-US's form105in any locale, and macros and their [API](../reference/macro-api.md)106set and read entries in en-US's form.107108[Excel files](../files/excel.md) are downloaded with the locale's109Currency, Date, Time and Date time formats, tagged with it as Excel110writes them (`#,##0.00\ [$€-407]`, `[$-407]d.m.yyyy`), so Excel shows111them as the sheet does. Opened in a sheet of the same locale they are112those formats again; in another they keep their symbol and order as113custom formats.