# General Translation Platform: formatCurrency
URL: https://generaltranslation.com/es/docs/platform/core/reference/utility-functions/formatting/format-currency.mdx
---
title: formatCurrency
description: Formatea un valor monetario según la configuración regional sin una instancia de GT. Referencia de la API de formatCurrency.

---

[`formatCurrency`](/docs/platform/core/reference/gt-class-methods/formatting/format-currency) es una función de utilidad independiente de la biblioteca Core de General Translation que formatea un valor numérico como una cadena monetaria localizada. Envuelve la API integrada `Intl.NumberFormat` con el estilo de moneda.

## Descripción general [#overview]

Importa `formatCurrency` directamente desde `generaltranslation` y llámalo con un valor, un código de moneda y un objeto de opciones. No requiere una clave de API ni una instancia de [GT](/docs/platform/core/reference/gt-class/constructor). Si quieres un formato basado en instancias que herede la configuración regional de la instancia, usa en su lugar el método [`formatCurrency`](/docs/platform/core/reference/gt-class-methods/formatting/format-currency) de una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

const price = formatCurrency(1234.56, 'EUR', { locales: ['de-DE'] });
// "1.234,56 €"
```

Firma:

```typescript
formatCurrency(
  value: number,
  currency: string,
  options?: { locales?: string | string[] } & Intl.NumberFormatOptions
): string
```

## Cómo funciona [#how-it-works]

* **API subyacente.** Usa el mismo [`Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) con `style: 'currency'` que el método de la clase GT.
* **Resolución de la configuración regional.** Cuando se omite `locales`, recurre a la configuración regional predeterminada de la biblioteca, `en`.
* **Posición del símbolo.** El símbolo de moneda, los separadores de agrupación y el formato decimal siguen la configuración regional resuelta.

## Parámetros [#parameters]

| Parámetro               | Descripción                                                                    | Tipo                                                          | Opcional | Predeterminado |
| ----------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------- | -------- | -------------- |
| [`value`](#value)       | El valor numérico que se va a formatear.                                       | `number`                                                      | No       | —              |
| [`currency`](#currency) | El código de divisa ISO 4217, como `USD` o `EUR`.                            | `string`                                                      | No       | —              |
| [`options`](#options)   | Configuración de formato, incluidas las configuraciones regionales de destino. | `{ locales?: string \| string[] } & Intl.NumberFormatOptions` | Sí       | `{}`           |

### `value` [#value]

**Tipo** `number` · **Obligatorio**

El valor numérico que se va a formatear.

### `currency` [#currency]

**Type** `string` · **Obligatorio**

El código de divisa ISO 4217, como `USD`, `EUR` o `JPY`.

### `options` [#options]

**Type** `{ locales?: string | string[] } & Intl.NumberFormatOptions` · **Opcional** · **Predeterminado** `{}`

Configuración de formato:

| Propiedad | Descripción                                                                      | Type                 | Opcional | Predeterminado |
| --------- | -------------------------------------------------------------------------------- | -------------------- | -------- | -------------- |
| `locales` | Configuración regional para el formato.                                          | `string \| string[]` | Sí       | `en`           |
| `style`   | Estilo de formato de números; de forma predeterminada, usa el formato de moneda. | `string`             | Sí       | `'currency'`   |

## Returns [#returns]

**Type** `string`

El valor formateado como una cadena monetaria localizada.

## Ejemplos [#examples]

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

// Dólares estadounidenses
console.log(formatCurrency(1234.56, 'USD', { locales: 'en-US' }));
// Output: "$1,234.56"

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

// Yenes japoneses (sin decimales)
console.log(formatCurrency(1234, 'JPY', { locales: 'ja-JP' }));
// Output: "￥1,234"
```

## Notas [#notes]

* Pasa siempre un valor explícito de `locales` para obtener un resultado correcto y determinista.
* Pasa cualquier `Intl.NumberFormatOptions` (por ejemplo, `minimumFractionDigits`) junto con `locales` para ajustar con mayor precisión el resultado.