# General Translation Platform: formatCurrency
URL: https://generaltranslation.com/fr/docs/platform/core/reference/utility-functions/formatting/format-currency.mdx
---
title: formatCurrency
description: Met en forme une valeur monétaire selon le paramètre régional sans instance GT. Référence d’API pour formatCurrency.

---

[`formatCurrency`](/docs/platform/core/reference/gt-class-methods/formatting/format-currency) est une fonction utilitaire autonome de la bibliothèque Core de General Translation qui met en forme une valeur numérique sous forme de chaîne monétaire localisée. Elle encapsule l’API intégrée `Intl.NumberFormat` avec le style `currency`.

## Vue d’ensemble [#overview]

Importez `formatCurrency` directement depuis `generaltranslation` et appelez-la avec une valeur, un code de devise et un objet d’options. Elle ne nécessite ni clé API ni instance de [GT](/docs/platform/core/reference/gt-class/constructor). Pour un formatage basé sur une instance et qui hérite du paramètre régional de celle-ci, utilisez plutôt la méthode [`formatCurrency`](/docs/platform/core/reference/gt-class-methods/formatting/format-currency) sur une instance de [`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 €"
```

Signature :

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

## Fonctionnement [#how-it-works]

* **API sous-jacente.** Utilise le même [`Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) avec `style: 'currency'` que la méthode de la classe GT.
* **Résolution du paramètre régional.** Si `locales` est omis, le paramètre régional par défaut de la bibliothèque, `en`, est utilisé.
* **Placement du symbole.** Le symbole monétaire, les séparateurs de groupement et le format décimal dépendent du paramètre régional résolu.

## Paramètres [#parameters]

| Paramètre               | Description                                                                  | Type                                                          | Facultatif | Par défaut |
| ----------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------- | ---------- | ---------- |
| [`value`](#value)       | La valeur numérique à formater.                                              | `number`                                                      | Non        | —          |
| [`currency`](#currency) | Le code de devise ISO 4217, par exemple `USD` ou `EUR`.                      | `string`                                                      | Non        | —          |
| [`options`](#options)   | Configuration de formatage, y compris le ou les paramètres régionaux cibles. | `{ locales?: string \| string[] } & Intl.NumberFormatOptions` | Oui        | `{}`       |

### `value` [#value]

**Type** `number` · **Obligatoire**

La valeur numérique à formater.

### `currency` [#currency]

**Type** `string` · **Obligatoire**

Le code de devise ISO 4217, comme `USD`, `EUR` ou `JPY`.

### `options` [#options]

**Type** `{ locales?: string | string[] } & Intl.NumberFormatOptions` · **Facultatif** · **Par défaut** `{}`

Options de formatage :

| Propriété | Description                                                              | Type                 | Facultatif | Par défaut   |
| --------- | ------------------------------------------------------------------------ | -------------------- | ---------- | ------------ |
| `locales` | Paramètre(s) régional(aux) à utiliser pour le formatage.                 | `string \| string[]` | Oui        | `en`         |
| `style`   | Style de formatage des nombres ; utilise par défaut le format monétaire. | `string`             | Oui        | `'currency'` |

## Returns [#returns]

**Type** `string`

La valeur formatée comme une chaîne monétaire localisée.

## Exemples [#examples]

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

// Dollars américains
console.log(formatCurrency(1234.56, 'USD', { locales: 'en-US' }));
// Output: "$1,234.56"

// Euros, paramètre régional allemand
console.log(formatCurrency(1234.56, 'EUR', { locales: 'de-DE' }));
// Output: "1.234,56 €"

// Yen japonais (sans chiffres décimaux)
console.log(formatCurrency(1234, 'JPY', { locales: 'ja-JP' }));
// Output: "￥1,234"
```

## Remarques [#notes]

* Passez toujours une valeur `locales` explicite afin d’obtenir une sortie correcte et déterministe.
* Passez n’importe quelle option `Intl.NumberFormatOptions` (par exemple `minimumFractionDigits`) avec `locales` pour affiner le résultat.