From e08b17636b13f9b44342ca8b01943e5d87c6b38b Mon Sep 17 00:00:00 2001
From: lab900-marcel-samyn
 <67897574+lab900-marcel-samyn@users.noreply.github.com>
Date: Fri, 4 Dec 2020 07:25:43 +0100
Subject: [PATCH] [v3] Add locale to ChartOptions type (#8118)

* Add locale to ChartOptions type

* Adds locale options documentation

* fixed typo

* changes links to number format, linking the constructor

* changes to a better sentence

* changes to better sentence (2)

Co-authored-by: stock <stocki.nail@gmail.com>
---
 docs/docs/general/locale.md | 25 +++++++++++++++++++++++++
 docs/sidebars.js            |  1 +
 types/core/interfaces.d.ts  |  6 ++++++
 3 files changed, 32 insertions(+)
 create mode 100644 docs/docs/general/locale.md

diff --git a/docs/docs/general/locale.md b/docs/docs/general/locale.md
new file mode 100644
index 000000000..e1f085bce
--- /dev/null
+++ b/docs/docs/general/locale.md
@@ -0,0 +1,25 @@
+---
+title: Locale
+---
+
+For applications where the numbers of ticks on scales must be formatted accordingly with a language sensitive number formatting, you can enable this kind of formatting by setting the `locale` option.
+
+The locale is a string that is a [Unicode BCP 47 locale identifier](https://www.unicode.org/reports/tr35/tr35.html#BCP_47_Conformance).
+
+A Unicode BCP 47 locale identifier consists of
+
+  1. a language code,
+  2. (optionally) a script code,
+  3. (optionally) a region (or country) code,
+  4. (optionally) one or more variant codes, and
+  5. (optionally) one or more extension sequences,
+
+with all present components separated by hyphens. 
+
+By default the chart is using the default locale of the platform which is running on.
+
+## Configuration Options
+
+| Name | Type | Default | Description
+| ---- | ---- | ------- | -----------
+| `locale` | `string` | `undefined` | a string with a BCP 47 language tag, leveraging on [INTL NumberFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat).
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 3300e2114..b56c31367 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -16,6 +16,7 @@ module.exports = {
 			'general/accessibility',
 			'general/responsive',
 			'general/device-pixel-ratio',
+			'general/locale',
 			{Interactions: ['general/interactions/index', 'general/interactions/events', 'general/interactions/modes']},
 			'general/options',
 			'general/colors',
diff --git a/types/core/interfaces.d.ts b/types/core/interfaces.d.ts
index ab82d4e11..ff6e1a282 100644
--- a/types/core/interfaces.d.ts
+++ b/types/core/interfaces.d.ts
@@ -131,6 +131,12 @@ export interface CoreChartOptions extends ParsingOptions {
    * @default 2
    */
   aspectRatio: number;
+	
+  /**
+   * Locale used for number formatting (using `Intl.NumberFormat`).
+   * @default user's browser setting
+   */
+  locale: string;
 
   /**
    * Called when a resize occurs. Gets passed two arguments: the chart instance and the new size.
-- 
2.47.2