# generaltranslation: General Translation Core SDK: formatNum
URL: https://generaltranslation.com/es/docs/core/functions/formatting/format-num.mdx
---
title: formatNum
description: Función independiente para dar formato a números según las convenciones de la configuración regional
---

## Resumen

La función independiente `formatNum` da formato a los números según convenciones específicas de la configuración regional, sin requerir una instancia de GT.
Ofrece la misma funcionalidad que el método de la clase GT, pero puede usarse de forma independiente.

```typescript
import { formatNum } from 'generaltranslation';

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


## Referencia

### Parámetros

| Nombre    | Tipo                                                    | Descripción                                         |
| --------- | ------------------------------------------------------- | --------------------------------------------------- |
| `number`  | `number`                                                | El número al que se va a dar formato                |
| `options` | `NumberFormatOptions & { locales: string \| string[] }` | Configuración de formato con `locales` obligatorios |

### NumberFormatOptions

| Nombre                   | Tipo                                                       | Descripción                                                     |
| ------------------------ | ---------------------------------------------------------- | --------------------------------------------------------------- |
| `locales`                | `string \| string[]`                                       | **Obligatorio**: locales para dar formato                       |
| `style?`                 | `'decimal' \| 'currency' \| 'percent' \| 'unit'`           | Estilo de formato de número                                     |
| `currency?`              | `string`                                                   | Código de moneda (obligatorio cuando el estilo 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

`cadena` - El número con formato según las convenciones de la configuración regional.

***

## Ejemplo

### Uso básico

```typescript copy
import { formatNum } from 'generaltranslation';

// Formato de número básico
console.log(formatNum(1234.567, { locales: 'en-US' }));
// Salida: "1,234.567"

// Formato alemán
console.log(formatNum(1234.567, { locales: 'de-DE' }));
// Salida: "1.234,567"
```


### Formato de moneda

```typescript copy
// Dólar estadounidense
console.log(formatNum(1234.56, {
  locales: 'en-US',
  style: 'currency',
  currency: 'USD'
}));
// Salida: "$1,234.56"

// Euro con configuración regional alemana
console.log(formatNum(1234.56, {
  locales: 'de-DE',
  style: 'currency',
  currency: 'EUR'
}));
// Salida: "1.234,56 €"

// Yen japonés
console.log(formatNum(1234.56, {
  locales: 'ja-JP',
  style: 'currency',
  currency: 'JPY'
}));
// Salida: "¥1,235"
```

***


## Notas

* A diferencia del método de la clase GT, el parámetro `locales` es obligatorio
* Usa el mismo `Intl.NumberFormat` subyacente que el método de la clase GT
* Los resultados se almacenan en caché internamente para mejorar el rendimiento cuando se repiten las combinaciones de configuración regional y opciones
* Las configuraciones regionales alternativas se procesan en orden si la configuración regional principal no es compatible
* Todas las opciones estándar de `Intl.NumberFormat` son compatibles

## Próximos pasos

* Consulta la [documentación de `Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) para ver más opciones
* Consulta [`formatDateTime`](/docs/core/functions/formatting/format-date-time) para dar formato a fechas de forma independiente
* Consulta [`formatMessage`](/docs/core/functions/formatting/format-message) para dar formato a mensajes de forma independiente
* Consulta [`formatNum`](/docs/core/class/methods/formatting/format-num) de la clase GT para usarlo a nivel de instancia