# generaltranslation: General Translation Core SDK: formatNum
URL: https://generaltranslation.com/fr/docs/core/functions/formatting/format-num.mdx
---
title: formatNum
description: Fonction autonome de formatage des nombres selon les conventions du paramètre régional
---

## Vue d’ensemble

La fonction autonome `formatNum` met en forme les nombres selon les conventions du paramètre régional, sans nécessiter d’instance de GT.
Elle offre la même fonctionnalité que la méthode de la classe GT, mais peut être utilisée de façon indépendante.

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

const formatted = formatNum(1234.56, {
  locales: 'de-DE',
  style: 'currency',
  currency: 'EUR'
});
// Retourne : "1.234,56 €"
```


## Référence

### Paramètres

| Nom       | Type                                                    | Description                                                   |
| --------- | ------------------------------------------------------- | ------------------------------------------------------------- |
| `number`  | `number`                                                | Le nombre à formater                                          |
| `options` | `NumberFormatOptions & { locales: string \| string[] }` | Configuration de formatage avec le paramètre `locales` requis |

### NumberFormatOptions

| Nom                      | Type                                                       | Description                                                    |
| ------------------------ | ---------------------------------------------------------- | -------------------------------------------------------------- |
| `locales`                | `string \| string[]`                                       | **Obligatoire** - Paramètres régionaux pour le formatage       |
| `style?`                 | `'decimal' \| 'currency' \| 'percent' \| 'unit'`           | Style de formatage des nombres                                 |
| `currency?`              | `string`                                                   | Code de devise (obligatoire lorsque le style est `'currency'`) |
| `minimumIntegerDigits?`  | `number`                                                   | Nombre minimal de chiffres dans la partie entière (1-21)       |
| `minimumFractionDigits?` | `number`                                                   | Nombre minimal de chiffres dans la partie fractionnaire (0-20) |
| `maximumFractionDigits?` | `number`                                                   | Nombre maximal de chiffres dans la partie fractionnaire (0-20) |
| `useGrouping?`           | `boolean \| 'always' \| 'auto' \| 'min2'`                  | Indique si des séparateurs de groupement sont utilisés         |
| `notation?`              | `'standard' \| 'scientific' \| 'engineering' \| 'compact'` | Format de notation des nombres                                 |

### Renvoie

`string` - Le nombre formaté selon les conventions propres au paramètre régional.

***

## Exemple

### Utilisation de base

```typescript copy
import { formatNum } from 'generaltranslation';

// Formatage numérique de base
console.log(formatNum(1234.567, { locales: 'en-US' }));
// Résultat : "1,234.567"

// Formatage allemand
console.log(formatNum(1234.567, { locales: 'de-DE' }));
// Résultat : "1.234,567"
```


### Formatage des montants en devise

```typescript copy
// Dollar américain
console.log(formatNum(1234.56, {
  locales: 'en-US',
  style: 'currency',
  currency: 'USD'
}));
// Output: "$1,234.56"

// Euro avec le paramètre régional allemand
console.log(formatNum(1234.56, {
  locales: 'de-DE',
  style: 'currency',
  currency: 'EUR'
}));
// Output: "1.234,56 €"

// Yen japonais
console.log(formatNum(1234.56, {
  locales: 'ja-JP',
  style: 'currency',
  currency: 'JPY'
}));
// Output: "¥1,235"
```

***


## Remarques

* Contrairement à la méthode de la classe GT, le paramètre `locales` est obligatoire
* Utilise le même `Intl.NumberFormat` sous-jacent que la méthode de la classe GT
* Les résultats sont mis en cache en interne pour améliorer les performances lorsque les mêmes combinaisons de paramètre régional/options sont utilisées à plusieurs reprises
* Les paramètres régionaux de secours sont traités dans l'ordre si le paramètre régional principal n'est pas pris en charge
* Toutes les options standard d'`Intl.NumberFormat` sont prises en charge

## Étapes suivantes

* Consultez la documentation de [`Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) pour découvrir plus d’options
* Consultez [`formatDateTime`](/docs/core/functions/formatting/format-date-time) pour le formatage autonome des dates
* Consultez [`formatMessage`](/docs/core/functions/formatting/format-message) pour le formatage autonome des messages
* Consultez la méthode [`formatNum`](/docs/core/class/methods/formatting/format-num) de la classe GT pour une utilisation via une instance