# generaltranslation: General Translation Core SDK: formatNum
URL: https://generaltranslation.com/it/docs/core/functions/formatting/format-num.mdx
---
title: formatNum
description: Funzione autonoma per formattare i numeri in base alle convenzioni dell'impostazione regionale
---

## Panoramica

La funzione autonoma `formatNum` formatta i numeri secondo convenzioni specifiche dell'impostazione regionale, senza richiedere un'istanza di GT.
Offre le stesse funzionalità del metodo della classe GT, ma può essere utilizzata in modo indipendente.

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

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


## Guida di riferimento

### Parametri

| Nome      | Tipo                                                    | Descrizione                                               |
| --------- | ------------------------------------------------------- | --------------------------------------------------------- |
| `number`  | `number`                                                | Il numero da formattare                                   |
| `options` | `NumberFormatOptions & { locales: string \| string[] }` | Configurazione di formattazione con `locales` obbligatori |

### NumberFormatOptions

| Nome                     | Tipo                                                       | Descrizione                                                             |
| ------------------------ | ---------------------------------------------------------- | ----------------------------------------------------------------------- |
| `locales`                | `string \| string[]`                                       | **Obbligatorio** - Impostazioni regionali da usare per la formattazione |
| `style?`                 | `'decimal' \| 'currency' \| 'percent' \| 'unit'`           | Stile di formattazione dei numeri                                       |
| `currency?`              | `string`                                                   | Codice della valuta (obbligatorio quando lo stile è 'currency') |
| `minimumIntegerDigits?`  | `number`                                                   | Numero minimo di cifre intere (1-21)                                    |
| `minimumFractionDigits?` | `number`                                                   | Numero minimo di cifre frazionarie (0-20)                               |
| `maximumFractionDigits?` | `number`                                                   | Numero massimo di cifre frazionarie (0-20)                              |
| `useGrouping?`           | `boolean \| 'always' \| 'auto' \| 'min2'`                  | Indica se usare i separatori di raggruppamento                          |
| `notation?`              | `'standard' \| 'scientific' \| 'engineering' \| 'compact'` | Formato della notazione numerica                                        |

### Restituisce

`string` - Il numero formattato in base alle convenzioni dell'impostazione regionale.

***

## Esempio

### Utilizzo di base

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

// Formattazione numerica di base
console.log(formatNum(1234.567, { locales: 'en-US' }));
// Output: "1,234.567"

// Formattazione tedesca
console.log(formatNum(1234.567, { locales: 'de-DE' }));
// Output: "1.234,567"
```


### Formattazione della valuta

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

// Euro con impostazione regionale tedesca
console.log(formatNum(1234.56, {
  locales: 'de-DE',
  style: 'currency',
  currency: 'EUR'
}));
// Output: "1.234,56 €"

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

***


## Note

* A differenza del metodo della classe GT, il parametro `locales` è obbligatorio
* Usa lo stesso `Intl.NumberFormat` di base del metodo della classe GT
* I risultati vengono memorizzati internamente nella cache per migliorare le prestazioni quando si ripetono le stesse combinazioni di impostazione regionale e opzioni
* Le impostazioni regionali di fallback vengono elaborate in ordine se l'impostazione regionale principale non è supportata
* Sono supportate tutte le opzioni standard di `Intl.NumberFormat`

## Passaggi successivi

* Consulta la documentazione di [`Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) per altre opzioni
* Vedi [`formatDateTime`](/docs/core/functions/formatting/format-date-time) per la formattazione autonoma di data e ora
* Vedi [`formatMessage`](/docs/core/functions/formatting/format-message) per la formattazione autonoma dei messaggi
* Vedi il metodo [`formatNum`](/docs/core/class/methods/formatting/format-num) della classe GT per l'uso basato su istanza