Utility FunctionsFormatting

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

NomeTipoDescrizione
numbernumberNumero da formattare
optionsNumberFormatOptions & { locales: string | string[] }Configurazione di formattazione con impostazione obbligatoria delle locale

NumberFormatOptions

NomeTipoDescrizione
localesstring | string[]Obbligatorio - Impostazioni locali per la formattazione
style?'decimal' | 'currency' | 'percent' | 'unit'Stile di formattazione dei numeri
currency?stringCodice valuta (obbligatorio quando lo stile è 'currency')
minimumIntegerDigits?numberNumero minimo di cifre intere (1-21)
minimumFractionDigits?numberNumero minimo di cifre decimali (0-20)
maximumFractionDigits?numberNumero 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.NumberFormat sottostante 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

Come valuti questa guida?

formatNum