# General Translation Platform: formatCurrency URL: https://generaltranslation.com/it/docs/platform/core/reference/utility-functions/formatting/format-currency.mdx Docs index: https://generaltranslation.com/llms.txt 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] **Tipo** `{ locales?: string | string[] } & Intl.NumberFormatOptions` · **Facoltativo** · **Predefinito** `{}` Configurazione di formattazione. La tabella elenca le opzioni di valuta comuni esposte dai tipi Core pubblicati e i relativi valori predefiniti effettivi in Core. (Consulta le [opzioni del costruttore `Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#options) per ulteriori dettagli standard e specifici del runtime). | Proprietà | Descrizione | Tipo | Facoltativo | Predefinito | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ----------- | ----------------------------------------------------------------------------- | | `locales` | Impostazioni regionali per la formattazione. | `string \| string[]` | Sì | `en` | | `localeMatcher` | Algoritmo di corrispondenza delle impostazioni regionali. | `'lookup' \| 'best fit'` | Sì | `'best fit'` | | `numberingSystem` | Sistema di numerazione, ad esempio `latn` o `arab`. | `string` | Sì | `'latn'` | | `style` | Stile di formattazione dei numeri. `formatCurrency` imposta lo stile di valuta, a meno che non venga sovrascritto. | `'decimal' \| 'currency' \| 'percent' \| 'unit'` | Sì | `'currency'` | | `currency` | Codice valuta utilizzato dal formattatore. L'argomento posizionale `currency` imposta questo valore, a meno che non venga sovrascritto. | `string` | Sì | argomento posizionale `currency` | | `currencyDisplay` | Modalità di visualizzazione della valuta. | `'symbol' \| 'narrowSymbol' \| 'code' \| 'name'` | Sì | `'symbol'` | | `currencySign` | Segno di valuta da utilizzare. | `'standard' \| 'accounting'` | Sì | `'standard'` | | `unit` | Identificatore dell'unità. Obbligatorio quando `style` è `'unit'`. | `string` | Sì | — | | `unitDisplay` | Modalità di visualizzazione dell'unità. | `'short' \| 'narrow' \| 'long'` | Sì | `'short'` | | `minimumFractionDigits` | Numero minimo di cifre frazionarie (0–100). | `number` | Sì | cifre dell'unità minore della valuta; `0` con valori predefiniti compatti | | `maximumFractionDigits` | Numero massimo di cifre frazionarie (0–100), almeno `minimumFractionDigits`. | `number` | Sì | cifre dell'unità minore della valuta; `0` con valori predefiniti compatti | | `minimumSignificantDigits` | Numero minimo di cifre significative (1–21), quando è attivo l'arrotondamento alle cifre significative. | `number` | Sì | `1` | | `maximumSignificantDigits` | Numero massimo di cifre significative (1–21), quando è attivo l'arrotondamento alle cifre significative. | `number` | Sì | `21`; `2` con valori predefiniti compatti | | `roundingPriority` | Modalità di interazione tra le impostazioni delle cifre frazionarie e significative. | `'auto' \| 'morePrecision' \| 'lessPrecision'` | Sì | `'auto'`; `'morePrecision'` con valori predefiniti compatti | | `roundingMode` | Modalità di arrotondamento. | `'ceil' \| 'floor' \| 'expand' \| 'trunc' \| 'halfCeil' \| 'halfFloor' \| 'halfExpand' \| 'halfTrunc' \| 'halfEven'` | Sì | `'halfExpand'` | | `roundingIncrement` | Incremento di arrotondamento. I valori diversi da quello predefinito richiedono che il numero effettivo minimo e massimo di cifre frazionarie sia uguale e non possono essere combinati con l'arrotondamento alle cifre significative o con un valore di `roundingPriority` diverso da `'auto'`. | `1 \| 2 \| 5 \| 10 \| 20 \| 25 \| 50 \| 100 \| 200 \| 250 \| 500 \| 1000 \| 2000 \| 2500 \| 5000` | Sì | `1` | | `useGrouping` | Se e quando utilizzare i separatori di raggruppamento. | `boolean \| 'always' \| 'auto' \| 'min2'` | Sì | `'auto'`; `'min2'` con valori predefiniti compatti | | `notation` | Formato della notazione numerica. | `'standard' \| 'scientific' \| 'engineering' \| 'compact'` | Sì | `'standard'` | | `compactDisplay` | Stile di visualizzazione della notazione compatta. | `'short' \| 'long'` | Sì | `'short'` | | `signDisplay` | Quando visualizzare il segno. | `'auto' \| 'never' \| 'always' \| 'exceptZero' \| 'negative'` | Sì | `'auto'` | | `trailingZeroDisplay` | Se visualizzare gli zeri finali. | `'auto' \| 'stripIfInteger'` | Sì | `'auto'` | Quando `notation: 'compact'` è impostato senza alcuna opzione per le cifre frazionarie o significative, i valori effettivi predefiniti sono `minimumFractionDigits: 0`, `maximumFractionDigits: 0`, `minimumSignificantDigits: 1` e `maximumSignificantDigits: 2`. In tal caso, il valore predefinito di `roundingPriority` è `'morePrecision'` e quello di `useGrouping` è `'min2'`. L'impostazione di `style: 'unit'` richiede inoltre un `unit` valido. ## 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. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.