Aperçu

La fonction autonome formatNum formate les nombres selon les conventions propres à la locale, sans nécessiter d’instance de GT. Elle offre la même fonctionnalité que la méthode de la GT class, mais peut être utilisée de manière indépendante.

import { formatNum } from 'generaltranslation';

const formatted = formatNum(1234.56, {
  locales: 'de-DE',
  style: 'currency',
  currency: 'EUR'
});
// Renvoie : « 1.234,56 € »

Références

Paramètres

NumberFormatOptions

Renvoie

string - Le nombre formaté selon les conventions de la locale.

Exemple

Utilisation de base

import { formatNum } from 'generaltranslation';

// Formatage de base des nombres
console.log(formatNum(1234.567, { locales: 'en-US' }));
// Résultat : "1,234.567"

// Formatage allemand
console.log(formatNum(1234.567, { locales: 'de-DE' }));
// Résultat : "1.234,567"

Mise en forme des devises

// Dollar américain
console.log(formatNum(1234.56, {
  locales: 'en-US',
  style: 'currency',
  currency: 'USD'
}));
// Résultat : "$1,234.56"

// Euro avec locale allemande
console.log(formatNum(1234.56, {
  locales: 'de-DE',
  style: 'currency',
  currency: 'EUR'
}));
// Résultat : "1.234,56 €"

// Yen japonais
console.log(formatNum(1234.56, {
  locales: 'ja-JP',
  style: 'currency',
  currency: 'JPY'
}));
// Résultat : "¥1,235"

Notes

• Contrairement à la méthode de la GT class, le paramètre locales est obligatoire
• Utilise le même Intl.NumberFormat sous-jacent que la méthode de la GT class
• Les résultats sont mis en cache en interne pour optimiser les performances avec des combinaisons locale/options répétées
• Les locales de secours sont appliquées dans l’ordre si la locale principale n’est pas prise en charge
• Toutes les options standard de Intl.NumberFormat sont prises en charge

Prochaines étapes

• Consultez la documentation d’Intl.NumberFormat pour davantage d’options
• Consultez formatDateTime pour le formatage autonome des dates
• Consultez formatMessage pour le formatage autonome des messages
• Consultez la méthode de la classe GT formatNum pour un usage basé sur des instances
• Consultez formatCurrency pour un formatage spécialisé des devises