# General Translation Platform: formatCurrency
URL: https://generaltranslation.com/ru/docs/platform/core/reference/utility-functions/formatting/format-currency.mdx
---

title: formatCurrency
description: Форматирование значения Currency по локали без экземпляра GT. Справка по API для formatCurrency.

---

[`formatCurrency`](/docs/platform/core/reference/gt-class-methods/formatting/format-currency) — это автономная вспомогательная функция из core library General Translation, которая форматирует числовое значение в локализованную строку валюты. Она представляет собой обёртку над встроенным API `Intl.NumberFormat` со стилем currency.

## Обзор [#overview]

Импортируйте `formatCurrency` напрямую из `generaltranslation` и вызовите её, передав значение, код валюты и объект параметров. Для этого не требуется API-ключ или экземпляр [GT](/docs/platform/core/reference/gt-class/constructor). Если вам нужно форматирование через экземпляр с наследованием его локали, используйте метод [`formatCurrency`](/docs/platform/core/reference/gt-class-methods/formatting/format-currency) экземпляра [`GT`](/docs/platform/core/reference/gt-class/constructor).

```typescript
import { formatCurrency } from 'generaltranslation';

const price = formatCurrency(1234.56, 'EUR', { locales: ['de-DE'] });
// "1.234,56 €"
```

Сигнатура:

```typescript
formatCurrency(
  value: number,
  currency: string,
  options?: { locales?: string | string[] } & Intl.NumberFormatOptions
): string
```

## Как это работает [#how-it-works]

* **Базовый API.** Использует тот же [`Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) с `style: 'currency'`, что и метод класса GT.
* **Выбор локали.** Если `locales` не указан, используется локаль библиотеки по умолчанию — `en`.
* **Положение символа.** Символ валюты, разделители разрядов и формат десятичной части определяются выбранной локалью.

## Параметры [#parameters]

| Параметр                | Описание                                                     | Тип                                                           | Необязательный | По умолчанию |
| ----------------------- | ------------------------------------------------------------ | ------------------------------------------------------------- | -------------- | ------------ |
| [`value`](#value)       | Числовое значение, которое нужно отформатировать.            | `number`                                                      | Нет            | —            |
| [`currency`](#currency) | Код валюты по стандарту ISO 4217, например `USD` или `EUR`.  | `string`                                                      | Нет            | —            |
| [`options`](#options)   | Параметры форматирования, включая целевую локаль или локали. | `{ locales?: string \| string[] } & Intl.NumberFormatOptions` | Да             | `{}`         |

### `value` [#value]

**Тип** `number` · **Обязательно**

Числовое значение для форматирования.

### `currency` [#currency]

**Тип** `string` · **Обязательно**

Код валюты по стандарту ISO 4217, например `USD`, `EUR` или `JPY`.

### `options` [#options]

**Type** `{ locales?: string | string[] } & Intl.NumberFormatOptions` · **Необязательный** · **По умолчанию** `{}`

Параметры форматирования:

| Свойство  | Описание                                                          | Type                 | Необязательное | По умолчанию |
| --------- | ----------------------------------------------------------------- | -------------------- | -------------- | ------------ |
| `locales` | Локаль или локали для форматирования.                             | `string \| string[]` | Да             | `en`         |
| `style`   | Стиль форматирования чисел; по умолчанию — форматирование валюты. | `string`             | Да             | `'currency'` |

## Возвращаемое значение [#returns]

**Тип** `string`

Значение, отформатированное как локализованная строка валюты.

## Примеры [#examples]

```typescript
import { formatCurrency } from 'generaltranslation';

// Доллары США
console.log(formatCurrency(1234.56, 'USD', { locales: 'en-US' }));
// Output: "$1,234.56"

// Евро, немецкая локаль
console.log(formatCurrency(1234.56, 'EUR', { locales: 'de-DE' }));
// Output: "1.234,56 €"

// Японская иена (без дробных знаков)
console.log(formatCurrency(1234, 'JPY', { locales: 'ja-JP' }));
// Output: "￥1,234"
```

## Примечания [#notes]

* Для корректного и предсказуемого вывода всегда явно указывайте значение `locales`.
* Чтобы точнее настроить вывод, передавайте вместе с `locales` любые параметры `Intl.NumberFormatOptions` (например, `minimumFractionDigits`).