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

## Descripción general

La función autónoma `formatNum` da formato a los números según las convenciones de la configuración regional, sin necesidad de 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 que se va a formatear                    |
| `options` | `NumberFormatOptions & { locales: string \| string[] }` | Configuración de formato con `locales` obligatorio |

### NumberFormatOptions

| Nombre                   | Tipo                                                       | Descripción                                                     |
| ------------------------ | ---------------------------------------------------------- | --------------------------------------------------------------- |
| `locales`                | `string \| string[]`                                       | **Obligatorio**: configuraciones regionales para el formato     |
| `style?`                 | `'decimal' \| 'currency' \| 'percent' \| 'unit'`           | Estilo de formato numérico                                      |
| `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 decimales (0-20)                       |
| `maximumFractionDigits?` | `number`                                                   | Número máximo de dígitos decimales (0-20)                       |
| `useGrouping?`           | `boolean \| 'always' \| 'auto' \| 'min2'`                  | Indica si se usan separadores de agrupación                     |
| `notation?`              | `'standard' \| 'scientific' \| 'engineering' \| 'compact'` | Formato de notación numérica                                    |

### Devuelve

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

***

## Ejemplo

### Uso básico

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

// Formato numérico 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'
}));
// Output: "$1,234.56"

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

// Yen japonés
console.log(formatNum(1234.56, {
  locales: 'ja-JP',
  style: 'currency',
  currency: 'JPY'
}));
// Output: "¥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 de respaldo se procesan en orden si la configuración regional principal no es compatible
* Se admiten todas las opciones estándar de `Intl.NumberFormat`

## 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 conocer más opciones
* Consulta [`formatDateTime`](/docs/core/functions/formatting/format-date-time) para el formato autónomo de fechas
* Consulta [`formatMessage`](/docs/core/functions/formatting/format-message) para el formato autónomo de mensajes
* Consulta el método [`formatNum`](/docs/core/class/methods/formatting/format-num) de la clase GT para usarlo con una instancia