formatNum
Funzione standalone per formattare i numeri secondo le convenzioni locali
Panoramica
La funzione standalone formatNum formatta i numeri secondo le convenzioni locali senza richiedere un'istanza di GT.
Offre la stessa funzionalità del metodo della classe GT, ma può essere utilizzata in modo indipendente.
import { formatNum } from 'generaltranslation';
const formatted = formatNum(1234.56, {
locales: 'de-DE',
style: 'currency',
currency: 'EUR'
});
// Restituisce: "1.234,56 €"Riferimenti
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
number | number | Numero da formattare |
options | NumberFormatOptions & { locales: string | string[] } | Configurazione di formattazione con impostazione obbligatoria delle locale |
NumberFormatOptions
| Nome | Tipo | Descrizione |
|---|---|---|
locales | string | string[] | Obbligatorio - Impostazioni locali per la formattazione |
style? | 'decimal' | 'currency' | 'percent' | 'unit' | Stile di formattazione dei numeri |
currency? | string | Codice valuta (obbligatorio quando lo stile è 'currency') |
minimumIntegerDigits? | number | Numero minimo di cifre intere (1-21) |
minimumFractionDigits? | number | Numero minimo di cifre decimali (0-20) |
maximumFractionDigits? | number | Numero massimo di cifre decimali (0-20) |
useGrouping? | boolean | 'always' | 'auto' | 'min2' | Se utilizzare i separatori delle migliaia |
notation? | 'standard' | 'scientific' | 'engineering' | 'compact' | Formato di notazione numerica |
Restituisce
string - Il numero formattato secondo le convenzioni locali.
Esempio
Uso di base
import { formatNum } from 'generaltranslation';
// Formattazione di base dei numeri
console.log(formatNum(1234.567, { locales: 'en-US' }));
// Output: "1,234.567"
// Formattazione in tedesco
console.log(formatNum(1234.567, { locales: 'de-DE' }));
// Output: "1.234,567"Formattazione della valuta
// Dollaro USA
console.log(formatNum(1234.56, {
locales: 'en-US',
style: 'currency',
currency: 'USD'
}));
// Output: "$1,234.56"
// Euro con locale tedesco
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.NumberFormatsottostante del metodo della classe GT - I risultati vengono memorizzati in cache internamente per migliorare le prestazioni con combinazioni ripetute di locale/opzioni
- I fallback di locale vengono elaborati in ordine se il locale primario non è supportato
- Sono supportate tutte le opzioni standard di
Intl.NumberFormat
Prossimi passaggi
- Consulta la documentazione di
Intl.NumberFormatper ulteriori opzioni - Vedi
formatDateTimeper la formattazione indipendente delle date - Vedi
formatMessageper la formattazione indipendente dei messaggi - Vedi la classe GT
formatNumper l’uso a livello di istanza - Vedi
formatCurrencyper la formattazione specifica delle valute
Come valuti questa guida?