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

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

---

Formatta un valore numerico come stringa Currency localizzata in un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). General Translation usa l'API `Intl.NumberFormat` integrata con lo stile `currency`, così gli importi vengono visualizzati con il simbolo, il raggruppamento e le convenzioni decimali corretti per ogni impostazione regionale.

## Overview [#overview]

Chiama `formatCurrency` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor) con un valore numerico, un codice Currency e un oggetto options facoltativo. Restituisce la stringa della Currency formattata.

```typescript
const gt = new GT({ targetLocale: 'en-US' });

const price = gt.formatCurrency(1234.56, 'USD');
// "$1,234.56"
```

Firma:

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

*Nota: `formatCurrency` viene eseguito localmente tramite `Intl.NumberFormat` e non richiede una chiave API. Per impostazione predefinita formatta usando l'impostazione regionale di destinazione dell'istanza, ripiegando prima sull'impostazione regionale sorgente e poi su quella predefinita della library (`en`); passa `locales` per sovrascrivere questo comportamento. Per la formattazione senza un'istanza `GT`, vedi [`formatCurrency`](/docs/platform/core/reference/utility-functions/formatting/format-currency) standalone.*

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

* **Stile Currency.** La formattazione è delegata a [`Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) con `style: 'currency'` e il codice `currency` fornito.
* **Risoluzione dell'impostazione regionale.** Per impostazione predefinita, il metodo formatta usando l'impostazione regionale di destinazione dell'istanza, con fallback prima all'impostazione regionale sorgente e poi a quella predefinita della libreria (`en`) — non all'array di configurazione `locales`. Passa `locales` nelle opzioni per sovrascrivere questo comportamento.
* **Posizionamento del simbolo.** Il simbolo della Currency, i separatori delle migliaia e il formato decimale seguono l'impostazione regionale risolta, non il paese della Currency.

## Parametri [#parameters]

| Parametro               | Descrizione                                                                                          | Tipo     | Facoltativo | Predefinito |
| ----------------------- | ---------------------------------------------------------------------------------------------------- | -------- | ----------- | ----------- |
| [`value`](#value)       | Il valore numerico da formattare.                                                                    | `number` | No          | —           |
| [`currency`](#currency) | Il codice Currency ISO 4217, ad esempio `USD` o `EUR`.                                               | `string` | No          | —           |
| [`options`](#options)   | Configurazione di formattazione che estende `Intl.NumberFormatOptions` con un override di `locales`. | `object` | Sì          | —           |

### `value` [#value]

**Type** `number` · **Obbligatorio**

Il valore numerico da formattare.

### `currency` [#currency]

**Tipo** `stringa` · **Obbligatorio**

Il codice di Currency ISO 4217, ad esempio `USD`, `EUR` o `JPY`.

### `options` [#options]

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

Configurazione della formattazione. Estende `Intl.NumberFormatOptions` con un campo `locales` aggiuntivo:

| Name      | Description                                                                                        | Type                 | Optional | Default                                                 |
| --------- | -------------------------------------------------------------------------------------------------- | -------------------- | -------- | ------------------------------------------------------- |
| `locales` | Sovrascrive le impostazioni regionali per la formattazione.                                        | `string \| string[]` | Sì       | impostazione regionale di destinazione dell'istanza |
| `style`   | Stile di formattazione dei numeri; per impostazione predefinita usa la formattazione della valuta. | `string`             | Sì       | `'currency'`                                            |

## Returns [#returns]

**Type** `string`

Il valore formattato come stringa Currency localizzata.

## Esempi [#examples]

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

const gt = new GT({ targetLocale: 'en-US' });

// Impostazione regionale di destinazione dell'istanza predefinita
console.log(gt.formatCurrency(1234.56, 'USD'));
// Output: "$1,234.56"

// Sovrascrittura dell'impostazione regionale per singola chiamata
console.log(gt.formatCurrency(1234.56, 'EUR', { locales: ['de-DE'] }));
// Output: "1.234,56 €"

// Nessuna cifra decimale
console.log(gt.formatCurrency(1234, 'JPY', { locales: ['ja-JP'] }));
// Output: "￥1,234"
```

## Note [#notes]

* Il metodo usa internamente `Intl.NumberFormat`, nativo del browser, quindi gli importi seguono le convenzioni dell'impostazione regionale.
* Passa qualsiasi `Intl.NumberFormatOptions` (ad esempio `minimumFractionDigits`) insieme a `locales` per ottimizzare l'output.