/**

* @license

* Copyright Google LLC All Rights Reserved.

*

* Use of this source code is governed by an MIT-style license that can be

* found in the LICENSE file at https://angular.dev/license

*/

import {

ɵCurrencyIndex,

ɵExtraLocaleDataIndex,

ɵfindLocaleData,

ɵgetLocaleCurrencyCode,

ɵgetLocalePluralCase,

ɵLocaleDataIndex,

ɵRuntimeError as RuntimeError,

} from '@angular/core';

import {CURRENCIES_EN, CurrenciesSymbols} from './currencies';

import {RuntimeErrorCode} from '../errors';

/**

* Format styles that can be used to represent numbers.

* @see {@link getLocaleNumberFormat}

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated `getLocaleNumberFormat` is deprecated

*/

export enum NumberFormatStyle {

Decimal,

Percent,

Currency,

Scientific,

}

/**

* Plurality cases used for translating plurals to different languages.

*

* @see {@link NgPlural}

* @see {@link NgPluralCase}

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated `getLocalePluralCase` is deprecated

*/

export enum Plural {

Zero = 0,

One = 1,

Two = 2,

Few = 3,

Many = 4,

Other = 5,

}

/**

* Context-dependant translation forms for strings.

* Typically the standalone version is for the nominative form of the word,

* and the format version is used for the genitive case.

* @see [CLDR website](http://cldr.unicode.org/translation/date-time-1/date-time#TOC-Standalone-vs.-Format-Styles)

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated locale data getters are deprecated

*/

export enum FormStyle {

Format,

Standalone,

}

/**

* String widths available for translations.

* The specific character widths are locale-specific.

* Examples are given for the word "Sunday" in English.

*

* @publicApi

*

* @deprecated locale data getters are deprecated

*/

export enum TranslationWidth {

/** 1 character for `en-US`. For example: 'S' */

Narrow,

/** 3 characters for `en-US`. For example: 'Sun' */

Abbreviated,

/** Full length for `en-US`. For example: "Sunday" */

Wide,

/** 2 characters for `en-US`, For example: "Su" */

Short,

}

/**

* String widths available for date-time formats.

* The specific character widths are locale-specific.

* Examples are given for `en-US`.

*

* @see {@link getLocaleDateFormat}

* @see {@link getLocaleTimeFormat}

* @see {@link getLocaleDateTimeFormat}

* @see [Internationalization (i18n) Guide](guide/i18n)

* @publicApi

*

* @deprecated 18.0

* Date locale data getters are deprecated

*/

export enum FormatWidth {

/**

* For `en-US`, `'M/d/yy, h:mm a'`

* (Example: `6/15/15, 9:03 AM`)

*/

Short,

/**

* For `en-US`, `'MMM d, y, h:mm:ss a'`

* (Example: `Jun 15, 2015, 9:03:01 AM`)

*/

Medium,

/**

* For `en-US`, `'MMMM d, y, h:mm:ss a z'`

* (Example: `June 15, 2015 at 9:03:01 AM GMT+1`)

*/

Long,

/**

* For `en-US`, `'EEEE, MMMM d, y, h:mm:ss a zzzz'`

* (Example: `Monday, June 15, 2015 at 9:03:01 AM GMT+01:00`)

*/

Full,

}

// This needs to be an object literal, rather than an enum, because TypeScript 5.4+

// doesn't allow numeric keys and we have `Infinity` and `NaN`.

/**

* Symbols that can be used to replace placeholders in number patterns.

* Examples are based on `en-US` values.

*

* @see {@link getLocaleNumberSymbol}

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated `getLocaleNumberSymbol` is deprecated

*

* @object-literal-as-enum

*/

export const NumberSymbol = {

/**

* Decimal separator.

* For `en-US`, the dot character.

* Example: 2,345`.`67

*/

Decimal: 0,

/**

* Grouping separator, typically for thousands.

* For `en-US`, the comma character.

* Example: 2`,`345.67

*/

Group: 1,

/**

* List-item separator.

* Example: "one, two, and three"

*/

List: 2,

/**

* Sign for percentage (out of 100).

* Example: 23.4%

*/

PercentSign: 3,

/**

* Sign for positive numbers.

* Example: +23

*/

PlusSign: 4,

/**

* Sign for negative numbers.

* Example: -23

*/

MinusSign: 5,

/**

* Computer notation for exponential value (n times a power of 10).

* Example: 1.2E3

*/

Exponential: 6,

/**

* Human-readable format of exponential.

* Example: 1.2x103

*/

SuperscriptingExponent: 7,

/**

* Sign for permille (out of 1000).

* Example: 23.4‰

*/

PerMille: 8,

/**

* Infinity, can be used with plus and minus.

* Example: ∞, +∞, -∞

*/

Infinity: 9,

/**

* Not a number.

* Example: NaN

*/

NaN: 10,

/**

* Symbol used between time units.

* Example: 10:52

*/

TimeSeparator: 11,

/**

* Decimal separator for currency values (fallback to `Decimal`).

* Example: $2,345.67

*/

CurrencyDecimal: 12,

/**

* Group separator for currency values (fallback to `Group`).

* Example: $2,345.67

*/

CurrencyGroup: 13,

} as const;

export type NumberSymbol = (typeof NumberSymbol)[keyof typeof NumberSymbol];

/**

* The value for each day of the week, based on the `en-US` locale

*

* @publicApi

*

* @deprecated Week locale getters are deprecated

*/

export enum WeekDay {

Sunday = 0,

Monday,

Tuesday,

Wednesday,

Thursday,

Friday,

Saturday,

}

/**

* Retrieves the locale ID from the currently loaded locale.

* The loaded locale could be, for example, a global one rather than a regional one.

* @param locale A locale code, such as `fr-FR`.

* @returns The locale code. For example, `fr`.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* This function serves no purpose when relying on the `Intl` API.

*/

export function getLocaleId(locale: string): string {

return ɵfindLocaleData(locale)[ɵLocaleDataIndex.LocaleId];

}

/**

* Retrieves day period strings for the given locale.

*

* @param locale A locale code for the locale format rules to use.

* @param formStyle The required grammatical form.

* @param width The required character width.

* @returns An array of localized period strings. For example, `[AM, PM]` for `en-US`.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Use `Intl.DateTimeFormat` for date formating instead.

*/

export function getLocaleDayPeriods(

locale: string,

formStyle: FormStyle,

width: TranslationWidth,

): Readonly<[string, string]> {

const data = ɵfindLocaleData(locale);

const amPmData = <[string, string][][]>[

data[ɵLocaleDataIndex.DayPeriodsFormat],

data[ɵLocaleDataIndex.DayPeriodsStandalone],

];

const amPm = getLastDefinedValue(amPmData, formStyle);

return getLastDefinedValue(amPm, width);

}

/**

* Retrieves days of the week for the given locale, using the Gregorian calendar.

*

* @param locale A locale code for the locale format rules to use.

* @param formStyle The required grammatical form.

* @param width The required character width.

* @returns An array of localized name strings.

* For example,`[Sunday, Monday, ... Saturday]` for `en-US`.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Use `Intl.DateTimeFormat` for date formating instead.

*/

export function getLocaleDayNames(

locale: string,

formStyle: FormStyle,

width: TranslationWidth,

): ReadonlyArray<string> {

const data = ɵfindLocaleData(locale);

const daysData = <string[][][]>[

data[ɵLocaleDataIndex.DaysFormat],

data[ɵLocaleDataIndex.DaysStandalone],

];

const days = getLastDefinedValue(daysData, formStyle);

return getLastDefinedValue(days, width);

}

/**

* Retrieves months of the year for the given locale, using the Gregorian calendar.

*

* @param locale A locale code for the locale format rules to use.

* @param formStyle The required grammatical form.

* @param width The required character width.

* @returns An array of localized name strings.

* For example, `[January, February, ...]` for `en-US`.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Use `Intl.DateTimeFormat` for date formating instead.

*/

export function getLocaleMonthNames(

locale: string,

formStyle: FormStyle,

width: TranslationWidth,

): ReadonlyArray<string> {

const data = ɵfindLocaleData(locale);

const monthsData = <string[][][]>[

data[ɵLocaleDataIndex.MonthsFormat],

data[ɵLocaleDataIndex.MonthsStandalone],

];

const months = getLastDefinedValue(monthsData, formStyle);

return getLastDefinedValue(months, width);

}

/**

* Retrieves Gregorian-calendar eras for the given locale.

* @param locale A locale code for the locale format rules to use.

* @param width The required character width.

* @returns An array of localized era strings.

* For example, `[AD, BC]` for `en-US`.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Use `Intl.DateTimeFormat` for date formating instead.

*/

export function getLocaleEraNames(

locale: string,

width: TranslationWidth,

): Readonly<[string, string]> {

const data = ɵfindLocaleData(locale);

const erasData = <[string, string][]>data[ɵLocaleDataIndex.Eras];

return getLastDefinedValue(erasData, width);

}

/**

* Retrieves the first day of the week for the given locale.

*

* @param locale A locale code for the locale format rules to use.

* @returns A day index number, using the 0-based week-day index for `en-US`

* (Sunday = 0, Monday = 1, ...).

* For example, for `fr-FR`, returns 1 to indicate that the first day is Monday.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Intl's [`getWeekInfo`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getWeekInfo) has partial support (Chromium M99 & Safari 17).

* You may want to rely on the following alternatives:

* - Libraries like [`Luxon`](https://moment.github.io/luxon/#/) rely on `Intl` but fallback on the ISO 8601 definition (monday) if `getWeekInfo` is not supported.

* - Other librairies like [`date-fns`](https://date-fns.org/), [`day.js`](https://day.js.org/en/) or [`weekstart`](https://www.npmjs.com/package/weekstart) library provide their own locale based data for the first day of the week.

*/

export function getLocaleFirstDayOfWeek(locale: string): WeekDay {

const data = ɵfindLocaleData(locale);

return data[ɵLocaleDataIndex.FirstDayOfWeek];

}

/**

* Range of week days that are considered the week-end for the given locale.

*

* @param locale A locale code for the locale format rules to use.

* @returns The range of day values, `[startDay, endDay]`.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Intl's [`getWeekInfo`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getWeekInfo) has partial support (Chromium M99 & Safari 17).

* Libraries like [`Luxon`](https://moment.github.io/luxon/#/) rely on `Intl` but fallback on the ISO 8601 definition (Saturday+Sunday) if `getWeekInfo` is not supported .

*/

export function getLocaleWeekEndRange(locale: string): [WeekDay, WeekDay] {

const data = ɵfindLocaleData(locale);

return data[ɵLocaleDataIndex.WeekendRange];

}

/**

* Retrieves a localized date-value formatting string.

*

* @param locale A locale code for the locale format rules to use.

* @param width The format type.

* @returns The localized formatting string.

* @see {@link FormatWidth}

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Use `Intl.DateTimeFormat` for date formating instead.

*/

export function getLocaleDateFormat(locale: string, width: FormatWidth): string {

const data = ɵfindLocaleData(locale);

return getLastDefinedValue(data[ɵLocaleDataIndex.DateFormat], width);

}

/**

* Retrieves a localized time-value formatting string.

*

* @param locale A locale code for the locale format rules to use.

* @param width The format type.

* @returns The localized formatting string.

* @see {@link FormatWidth}

* @see [Internationalization (i18n) Guide](guide/i18n)

* @publicApi

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Use `Intl.DateTimeFormat` for date formating instead.

*/

export function getLocaleTimeFormat(locale: string, width: FormatWidth): string {

const data = ɵfindLocaleData(locale);

return getLastDefinedValue(data[ɵLocaleDataIndex.TimeFormat], width);

}

/**

* Retrieves a localized date-time formatting string.

*

* @param locale A locale code for the locale format rules to use.

* @param width The format type.

* @returns The localized formatting string.

* @see {@link FormatWidth}

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Use `Intl.DateTimeFormat` for date formating instead.

*/

export function getLocaleDateTimeFormat(locale: string, width: FormatWidth): string {

const data = ɵfindLocaleData(locale);

const dateTimeFormatData = <string[]>data[ɵLocaleDataIndex.DateTimeFormat];

return getLastDefinedValue(dateTimeFormatData, width);

}

/**

* Retrieves a localized number symbol that can be used to replace placeholders in number formats.

* @param locale The locale code.

* @param symbol The symbol to localize. Must be one of `NumberSymbol`.

* @returns The character for the localized symbol.

* @see {@link NumberSymbol}

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Use `Intl.NumberFormat` to format numbers instead.

*/

export function getLocaleNumberSymbol(locale: string, symbol: NumberSymbol): string {

const data = ɵfindLocaleData(locale);

const res = data[ɵLocaleDataIndex.NumberSymbols][symbol];

if (typeof res === 'undefined') {

if (symbol === NumberSymbol.CurrencyDecimal) {

return data[ɵLocaleDataIndex.NumberSymbols][NumberSymbol.Decimal];

} else if (symbol === NumberSymbol.CurrencyGroup) {

return data[ɵLocaleDataIndex.NumberSymbols][NumberSymbol.Group];

}

}

return res;

}

/**

* Retrieves a number format for a given locale.

*

* Numbers are formatted using patterns, like `#,###.00`. For example, the pattern `#,###.00`

* when used to format the number 12345.678 could result in "12'345,678". That would happen if the

* grouping separator for your language is an apostrophe, and the decimal separator is a comma.

*

* <b>Important:</b> The characters `.` `,` `0` `#` (and others below) are special placeholders

* that stand for the decimal separator, and so on, and are NOT real characters.

* You must NOT "translate" the placeholders. For example, don't change `.` to `,` even though in

* your language the decimal point is written with a comma. The symbols should be replaced by the

* local equivalents, using the appropriate `NumberSymbol` for your language.

*

* Here are the special characters used in number patterns:

*

* | Symbol | Meaning |

* |--------|---------|

* | . | Replaced automatically by the character used for the decimal point. |

* | , | Replaced by the "grouping" (thousands) separator. |

* | 0 | Replaced by a digit (or zero if there aren't enough digits). |

* | # | Replaced by a digit (or nothing if there aren't enough). |

* | ¤ | Replaced by a currency symbol, such as $ or USD. |

* | % | Marks a percent format. The % symbol may change position, but must be retained. |

* | E | Marks a scientific format. The E symbol may change position, but must be retained. |

* | ' | Special characters used as literal characters are quoted with ASCII single quotes. |

*

* @param locale A locale code for the locale format rules to use.

* @param type The type of numeric value to be formatted (such as `Decimal` or `Currency`.)

* @returns The localized format string.

* @see {@link NumberFormatStyle}

* @see [CLDR website](http://cldr.unicode.org/translation/number-patterns)

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Let `Intl.NumberFormat` determine the number format instead

*/

export function getLocaleNumberFormat(locale: string, type: NumberFormatStyle): string {

const data = ɵfindLocaleData(locale);

return data[ɵLocaleDataIndex.NumberFormats][type];

}

/**

* Retrieves the symbol used to represent the currency for the main country

* corresponding to a given locale. For example, '$' for `en-US`.

*

* @param locale A locale code for the locale format rules to use.

* @returns The localized symbol character,

* or `null` if the main country cannot be determined.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Use the `Intl` API to format a currency with from currency code

*/

export function getLocaleCurrencySymbol(locale: string): string | null {

const data = ɵfindLocaleData(locale);

return data[ɵLocaleDataIndex.CurrencySymbol] || null;

}

/**

* Retrieves the name of the currency for the main country corresponding

* to a given locale. For example, 'US Dollar' for `en-US`.

* @param locale A locale code for the locale format rules to use.

* @returns The currency name,

* or `null` if the main country cannot be determined.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Use the `Intl` API to format a currency with from currency code

*/

export function getLocaleCurrencyName(locale: string): string | null {

const data = ɵfindLocaleData(locale);

return data[ɵLocaleDataIndex.CurrencyName] || null;

}

/**

* Retrieves the default currency code for the given locale.

*

* The default is defined as the first currency which is still in use.

*

* @param locale The code of the locale whose currency code we want.

* @returns The code of the default currency for the given locale.

*

* @publicApi

*

* @deprecated We recommend you create a map of locale to ISO 4217 currency codes.

* Time relative currency data is provided by the CLDR project. See https://www.unicode.org/cldr/charts/44/supplemental/detailed_territory_currency_information.html

*/

export function getLocaleCurrencyCode(locale: string): string | null {

return ɵgetLocaleCurrencyCode(locale);

}

/**

* Retrieves the currency values for a given locale.

* @param locale A locale code for the locale format rules to use.

* @returns The currency values.

* @see [Internationalization (i18n) Guide](guide/i18n)

*/

function getLocaleCurrencies(locale: string): {[code: string]: CurrenciesSymbols} {

const data = ɵfindLocaleData(locale);

return data[ɵLocaleDataIndex.Currencies];

}

/**

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Use `Intl.PluralRules` instead

*/

export const getLocalePluralCase: (locale: string) => (value: number) => Plural =

ɵgetLocalePluralCase;

function checkFullData(data: any) {

if (!data[ɵLocaleDataIndex.ExtraData]) {

throw new RuntimeError(

RuntimeErrorCode.MISSING_EXTRA_LOCALE_DATA_FOR_LOCALE,

ngDevMode &&

`Missing extra locale data for the locale "${

data[ɵLocaleDataIndex.LocaleId]

}". Use "registerLocaleData" to load new data. See the "I18n guide" on angular.io to know more.`,

);

}

}

/**

* Retrieves locale-specific rules used to determine which day period to use

* when more than one period is defined for a locale.

*

* There is a rule for each defined day period. The

* first rule is applied to the first day period and so on.

* Fall back to AM/PM when no rules are available.

*

* A rule can specify a period as time range, or as a single time value.

*

* This functionality is only available when you have loaded the full locale data.

* See the ["I18n guide"](guide/i18n/format-data-locale).

*

* @param locale A locale code for the locale format rules to use.

* @returns The rules for the locale, a single time value or array of *from-time, to-time*,

* or null if no periods are available.

*

* @see {@link getLocaleExtraDayPeriods}

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* Let `Intl.DateTimeFormat` determine the day period instead.

*/

export function getLocaleExtraDayPeriodRules(locale: string): (Time | [Time, Time])[] {

const data = ɵfindLocaleData(locale);

checkFullData(data);

const rules = data[ɵLocaleDataIndex.ExtraData][ɵExtraLocaleDataIndex.ExtraDayPeriodsRules] || [];

return rules.map((rule: string | [string, string]) => {

if (typeof rule === 'string') {

return extractTime(rule);

}

return [extractTime(rule[0]), extractTime(rule[1])];

});

}

/**

* Retrieves locale-specific day periods, which indicate roughly how a day is broken up

* in different languages.

* For example, for `en-US`, periods are morning, noon, afternoon, evening, and midnight.

*

* This functionality is only available when you have loaded the full locale data.

* See the ["I18n guide"](guide/i18n/format-data-locale).

*

* @param locale A locale code for the locale format rules to use.

* @param formStyle The required grammatical form.

* @param width The required character width.

* @returns The translated day-period strings.

* @see {@link getLocaleExtraDayPeriodRules}

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* To extract a day period use `Intl.DateTimeFormat` with the `dayPeriod` option instead.

*/

export function getLocaleExtraDayPeriods(

locale: string,

formStyle: FormStyle,

width: TranslationWidth,

): string[] {

const data = ɵfindLocaleData(locale);

checkFullData(data);

const dayPeriodsData = <string[][][]>[

data[ɵLocaleDataIndex.ExtraData][ɵExtraLocaleDataIndex.ExtraDayPeriodFormats],

data[ɵLocaleDataIndex.ExtraData][ɵExtraLocaleDataIndex.ExtraDayPeriodStandalone],

];

const dayPeriods = getLastDefinedValue(dayPeriodsData, formStyle) || [];

return getLastDefinedValue(dayPeriods, width) || [];

}

/**

* Retrieves the writing direction of a specified locale

* @param locale A locale code for the locale format rules to use.

* @publicApi

* @returns 'rtl' or 'ltr'

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* For dates and numbers, let `Intl.DateTimeFormat()` and `Intl.NumberFormat()` determine the writing direction.

* The `Intl` alternative [`getTextInfo`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getTextInfo).

* has only partial support (Chromium M99 & Safari 17).

* 3rd party alternatives like [`rtl-detect`](https://www.npmjs.com/package/rtl-detect) can work around this issue.

*/

export function getLocaleDirection(locale: string): 'ltr' | 'rtl' {

const data = ɵfindLocaleData(locale);

return data[ɵLocaleDataIndex.Directionality];

}

/**

* Retrieves the first value that is defined in an array, going backwards from an index position.

*

* To avoid repeating the same data (as when the "format" and "standalone" forms are the same)

* add the first value to the locale data arrays, and add other values only if they are different.

*

* @param data The data array to retrieve from.

* @param index A 0-based index into the array to start from.

* @returns The value immediately before the given index position.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

*/

function getLastDefinedValue<T>(data: T[], index: number): T {

for (let i = index; i > -1; i--) {

if (typeof data[i] !== 'undefined') {

return data[i];

}

}

throw new RuntimeError(

RuntimeErrorCode.LOCALE_DATA_UNDEFINED,

ngDevMode && 'Locale data API: locale data undefined',

);

}

/**

* Represents a time value with hours and minutes.

*

* @publicApi

*

* @deprecated Locale date getters are deprecated

*/

export type Time = {

hours: number;

minutes: number;

};

/**

* Extracts the hours and minutes from a string like "15:45"

*/

function extractTime(time: string): Time {

const [h, m] = time.split(':');

return {hours: +h, minutes: +m};

}

/**

* Retrieves the currency symbol for a given currency code.

*

* For example, for the default `en-US` locale, the code `USD` can

* be represented by the narrow symbol `$` or the wide symbol `US$`.

*

* @param code The currency code.

* @param format The format, `wide` or `narrow`.

* @param locale A locale code for the locale format rules to use.

*

* @returns The symbol, or the currency code if no symbol is available.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* You can use `Intl.NumberFormat().formatToParts()` to extract the currency symbol.

* For example: `Intl.NumberFormat('en', {style:'currency', currency: 'USD'}).formatToParts().find(part => part.type === 'currency').value`

* returns `$` for USD currency code in the `en` locale.

* Note: `US$` is a currency symbol for the `en-ca` locale but not the `en-us` locale.

*/

export function getCurrencySymbol(code: string, format: 'wide' | 'narrow', locale = 'en'): string {

const currency = getLocaleCurrencies(locale)[code] || CURRENCIES_EN[code] || [];

const symbolNarrow = currency[ɵCurrencyIndex.SymbolNarrow];

if (format === 'narrow' && typeof symbolNarrow === 'string') {

return symbolNarrow;

}

return currency[ɵCurrencyIndex.Symbol] || code;

}

// Most currencies have cents, that's why the default is 2

const DEFAULT_NB_OF_CURRENCY_DIGITS = 2;

/**

* Reports the number of decimal digits for a given currency.

* The value depends upon the presence of cents in that particular currency.

*

* @param code The currency code.

* @returns The number of decimal digits, typically 0 or 2.

* @see [Internationalization (i18n) Guide](guide/i18n)

*

* @publicApi

*

* @deprecated Angular recommends relying on the `Intl` API for i18n.

* This function should not be used anymore. Let `Intl.NumberFormat` determine the number of digits to display for the currency

*/

export function getNumberOfCurrencyDigits(code: string): number {

let digits;

const currency = CURRENCIES_EN[code];

if (currency) {

digits = currency[ɵCurrencyIndex.NbOfDigits];

}

return typeof digits === 'number' ? digits : DEFAULT_NB_OF_CURRENCY_DIGITS;

}