# vue: URL: https://generaltranslation.com/it/docs/vue/reference/components/currency.mdx --- title: "" description: Formatta un importo monetario per l'impostazione regionale attiva. Riferimento API del componente . --- Il componente `` formatta un `value` numerico obbligatorio utilizzando lo stile valuta di `Intl.NumberFormat`. Modifica il formato di visualizzazione, ma non converte un importo da una valuta all'altra. ## Panoramica [#overview] Associa l'importo tramite `value` e, facoltativamente, seleziona un codice valuta ISO 4217: ```vue ``` Usalo da solo o come variabile di runtime all'interno di [``](/docs/vue/reference/components/t). ## Come funziona [#how-it-works] * Un numero viene formattato localmente come valuta. L'importo non viene tradotto né inviato per la conversione valutaria. * Una stringa deve rappresentare un numero completo. Le stringhe contenenti solo spazi e `null` vengono renderizzati come valori vuoti; una stringa numerica non valida viene renderizzata senza modifiche. * Il valore predefinito di `currency` è `USD`. Dopo aver unito `options`, il componente applica sempre la prop `currency` di primo livello e lo stile valuta, quindi `options.currency` e `options.style` non possono sovrascriverli. * Il contenuto figlio dello slot del formattatore viene ignorato. Fornisci sempre `value` e usa un tag autochiudente. * Il componente non aggiunge alcun wrapper HTML. ### Risoluzione dell'impostazione regionale Quando l'impostazione regionale attiva è quella predefinita configurata, la formattazione usa solo quest'ultima e ignora `locales`. Per qualsiasi altra impostazione regionale attiva, un formatter autonomo prova prima i `locales` espliciti, poi l'impostazione regionale attiva e infine quella predefinita. All'interno di [``](/docs/vue/reference/components/t), il contenuto sorgente di fallback usa l'impostazione regionale predefinita. Il contenuto tradotto prova l'impostazione regionale attiva e poi quella predefinita, mentre un prop `locales` esplicito viene ignorato. ## Props [#props] | Prop | Descrizione | Tipo | Facoltativo | Predefinito | | ----------------------- | ------------------------------------------------------ | -------------------------- | ----------- | ----------------------------------------------------- | | [`value`](#value) | Importo in valuta da formattare. | `number \| string \| null` | No | — | | [`currency`](#currency) | Codice valuta ISO 4217. | `string` | Sì | `USD` | | [`options`](#options) | Opzioni aggiuntive per `Intl.NumberFormat`. | `Intl.NumberFormatOptions` | Sì | `{}` | | [`locales`](#locales) | Impostazioni regionali preferite per la formattazione. | `string[]` | Sì | Ordine di risoluzione dell'impostazione regionale | ### `value` **Tipo** `number | string | null` · **Obbligatorio** L'importo numerico da formattare. Le stringhe numeriche vengono convertite con `Number()` prima della formattazione. Il valore rimane nella valuta selezionata; non viene applicato alcun tasso di cambio. ### `currency` **Tipo** `stringa` · **Facoltativo** · **Predefinito** `USD` Un codice ISO 4217, ad esempio `USD`, `EUR` o `JPY`. Questa prop determina la valuta anche se `options` include un campo `currency` diverso. ### `options` **Tipo** `Intl.NumberFormatOptions` · **Facoltativo** · **Predefinito** `{}` Opzioni aggiuntive passate a `Intl.NumberFormat`. Le opzioni comuni per la formattazione delle valute includono: | Opzione | Descrizione | Tipo | Facoltativo | Predefinito | | -------------------------- | --------------------------------------------------------- | ------------------------------------------------------------- | ----------- | --------------------------------------- | | `localeMatcher` | Algoritmo di corrispondenza delle impostazioni regionali. | `'lookup' \| 'best fit'` | Sì | `'best fit'` | | `numberingSystem` | Sistema di numerazione, ad esempio `latn` o `arab`. | `string` | Sì | Dipende dall'impostazione regionale | | `currencyDisplay` | Modalità di visualizzazione della valuta. | `'code' \| 'symbol' \| 'narrowSymbol' \| 'name'` | Sì | `'symbol'` | | `currencySign` | Notazione standard o contabile per i valori negativi. | `'standard' \| 'accounting'` | Sì | `'standard'` | | `minimumIntegerDigits` | Numero minimo di cifre intere. | `number` | Sì | `1` | | `minimumFractionDigits` | Numero minimo di cifre frazionarie. | `number` | Sì | Dipende dalla valuta | | `maximumFractionDigits` | Numero massimo di cifre frazionarie. | `number` | Sì | Dipende dalla valuta | | `minimumSignificantDigits` | Numero minimo di cifre significative. | `number` | Sì | `1` | | `maximumSignificantDigits` | Numero massimo di cifre significative. | `number` | Sì | `21` | | `useGrouping` | Quando visualizzare i separatori delle migliaia. | `boolean \| string` | Sì | Dipende dalla notazione | | `notation` | Notazione numerica. | `'standard' \| 'scientific' \| 'engineering' \| 'compact'` | Sì | `'standard'` | | `compactDisplay` | Lunghezza dell'etichetta della notazione compatta. | `'short' \| 'long'` | Sì | `'short'` | | `signDisplay` | Quando visualizzare il segno. | `'auto' \| 'always' \| 'exceptZero' \| 'negative' \| 'never'` | Sì | `'auto'` | | `roundingMode` | Direzione usata per l'arrotondamento. | `string` | Sì | Dipende dal runtime | Il componente imposta forzatamente `style: 'currency'` e il valore `currency` di primo livello. I valori predefiniti per le cifre frazionarie seguono le unità minori standard della valuta. Consulta le [opzioni di `Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#options) per l'elenco completo definito dal runtime. ### `locales` **Tipo** `string[]` · **Facoltativo** · **Predefinito** Ordine di risoluzione delle impostazioni regionali Codici locale BCP 47 preferiti per la formattazione autonoma. Vengono utilizzati prima delle impostazioni regionali attiva e predefinita solo se l'impostazione regionale attiva non corrisponde a quella predefinita configurata. ## Esempi [#examples] ```vue title="OrderTotal.vue" ```