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

title: formatCurrency
description: Formatta un valore monetario in base all'impostazione regionale senza un'istanza GT. Riferimento API per formatCurrency.

---

[`formatCurrency`](/docs/platform/core/reference/gt-class-methods/formatting/format-currency) è una funzione di utilità autonoma della libreria Core di General Translation che formatta un valore numerico in una stringa di valuta localizzata. Si basa sull'API integrata `Intl.NumberFormat` usando lo stile `currency`.

## Panoramica [#overview]

Importa `formatCurrency` direttamente da `generaltranslation` e chiamalo con un valore, un codice valuta e un oggetto options. Non richiede una chiave API né un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). Per la formattazione basata su istanza, che eredita l'impostazione regionale dell'istanza, usa invece il metodo [`formatCurrency`](/docs/platform/core/reference/gt-class-methods/formatting/format-currency) su un'istanza di [`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 €"
```

Firma:

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

## Come funziona [#how-it-works]

* **API sottostante.** Usa lo stesso [`Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) con `style: 'currency'` del metodo della classe GT.
* **Risoluzione dell'impostazione regionale.** Quando `locales` non è specificato, viene usata l'impostazione regionale predefinita della libreria, `en`.
* **Posizionamento del simbolo.** Il simbolo della valuta, i separatori delle migliaia e il formato decimale seguono l'impostazione regionale determinata.

## Parametri [#parameters]

| Parametro               | Descrizione                                                                         | Tipo                                                          | Facoltativo | Predefinito |
| ----------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------- | ----------- | ----------- |
| [`value`](#value)       | L'importo numerico da formattare.                                               | `number`                                                      | No          | —           |
| [`currency`](#currency) | Il codice valuta ISO 4217, come `USD` o `EUR`.                                      | `string`                                                      | No          | —           |
| [`options`](#options)   | Configurazione di formattazione, incluse le impostazioni regionali di destinazione. | `{ locales?: string \| string[] } & Intl.NumberFormatOptions` | Sì          | `{}`        |

### `value` [#value]

**Type** `number` · **Required**

Il valore numerico da formattare.

### `currency` [#currency]

**Tipo** `string` · **Obbligatorio**

Il codice ISO 4217 della valuta, ad esempio `USD`, `EUR` o `JPY`.

### `options` [#options]

**Type** `{ locales?: string | string[] } & Intl.NumberFormatOptions` · **Facoltativo** · **Predefinito** `{}`

Configurazione di formattazione:

| Proprietà | Descrizione                                                                                      | Type                 | Facoltativo | Predefinito  |
| --------- | ------------------------------------------------------------------------------------------------ | -------------------- | ----------- | ------------ |
| `locales` | Impostazioni regionali per la formattazione.                                                     | `string \| string[]` | Sì          | `en`         |
| `style`   | Stile di formattazione dei numeri; per impostazione predefinita è la formattazione della valuta. | `string`             | Sì          | `'currency'` |

## Restituisce [#returns]

**Tipo** `string`

Il valore formattato come stringa di valuta in formato locale.

## Esempi [#examples]

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

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

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

// Yen giapponese (nessuna cifra decimale)
console.log(formatCurrency(1234, 'JPY', { locales: 'ja-JP' }));
// Output: "￥1,234"
```

## Note [#notes]

* Specifica sempre un valore `locales` esplicito per ottenere un output corretto e deterministico.
* Specifica eventuali `Intl.NumberFormatOptions` (ad esempio `minimumFractionDigits`) insieme a `locales` per perfezionare l'output.