formatNum
Función independiente para formatear números según las convenciones del locale
Descripción general
La función independiente formatNum da formato a números según las convenciones específicas de cada locale sin requerir una instancia de GT.
Ofrece la misma funcionalidad que el método de la GT class, pero puede usarse de forma independiente.
import { formatNum } from 'generaltranslation';
const formatted = formatNum(1234.56, {
locales: 'de-DE',
style: 'currency',
currency: 'EUR'
});
// Devuelve: "1.234,56 €"Referencias
Parámetros
| Name | Type | Description |
|---|---|---|
number | number | Número a formatear |
options | NumberFormatOptions & { locales: string | string[] } | Configuración de formato con locales requeridos |
NumberFormatOptions
| Name | Type | Descripción |
|---|---|---|
locales | string | string[] | Obligatorio: configuraciones regionales para el formateo |
style? | 'decimal' | 'currency' | 'percent' | 'unit' | Estilo de formato numérico |
currency? | string | Código de moneda (obligatorio cuando style es 'currency') |
minimumIntegerDigits? | number | Número mínimo de dígitos enteros (1-21) |
minimumFractionDigits? | number | Número mínimo de dígitos fraccionarios (0-20) |
maximumFractionDigits? | number | Número máximo de dígitos fraccionarios (0-20) |
useGrouping? | boolean | 'always' | 'auto' | 'min2' | Si se usan separadores de agrupación |
notation? | 'standard' | 'scientific' | 'engineering' | 'compact' | Formato de notación numérica |
Devuelve
string - El número formateado según las convenciones del locale.
Ejemplo
Uso básico
import { formatNum } from 'generaltranslation';
// Formato básico de números
console.log(formatNum(1234.567, { locales: 'en-US' }));
// Resultado: "1,234.567"
// Formato alemán
console.log(formatNum(1234.567, { locales: 'de-DE' }));
// Resultado: "1.234,567"Formato de divisas
// Dólar estadounidense
console.log(formatNum(1234.56, {
locales: 'en-US',
style: 'currency',
currency: 'USD'
}));
// Resultado: "$1,234.56"
// Euro con locale alemán
console.log(formatNum(1234.56, {
locales: 'de-DE',
style: 'currency',
currency: 'EUR'
}));
// Resultado: "1.234,56 €"
// Yen japonés
console.log(formatNum(1234.56, {
locales: 'ja-JP',
style: 'currency',
currency: 'JPY'
}));
// Resultado: "¥1,235"Notas
- A diferencia del método de la GT class, el parámetro
localeses obligatorio - Utiliza la misma
Intl.NumberFormatsubyacente que el método de la GT class - Los resultados se almacenan en caché internamente para mejorar el rendimiento con combinaciones repetidas de locale/options
- Las locales de contenido de respaldo predeterminado se procesan en orden si la locale principal no es compatible
- Se admiten todas las options estándar de
Intl.NumberFormat
Próximos pasos
- Consulta la documentación de
Intl.NumberFormatpara más options - Consulta
formatDateTimepara el formateo independiente de fechas - Consulta
formatMessagepara el formateo independiente de mensajes - Consulta
formatNumde la clase GT para uso basado en instancias - Consulta
formatCurrencypara el formateo especializado de moneda
¿Qué te parece esta guía?