# node: getLocale
URL: https://generaltranslation.com/es/docs/node/api/get-locale.mdx
---
title: getLocale
description: Referencia de la API para la función getLocale
---

## Resumen

La función `getLocale` devuelve la configuración regional actual del contexto de la solicitud activa.

```js
import { getLocale } from 'gt-node';

const locale = getLocale(); // 'en-US'
```

<Callout>
  **Se requiere contexto de solicitud:**
  `getLocale` debe llamarse dentro de una callback de [`withGT`](/docs/node/api/with-gt) para que sepa qué configuración regional usar.
</Callout>


## Referencia

### Parámetros

Ninguno.

### Devuelve

`string` — El [código de configuración regional](/docs/core/locales) actual según BCP 47 (p. ej., `'en-US'`).

***

## Ejemplos

### Uso básico

```js title="handler.js"
import { withGT, getLocale } from 'gt-node';

app.use((req, res, next) => {
  const locale = req.headers['accept-language']?.split(',')[0] || 'en-US';
  withGT(locale, () => {
    console.log(getLocale()); // 'en-US'
    next();
  });
});
```

***


## Siguientes pasos

* Consulta [`getLocales`](/docs/node/api/get-locales) para ver la lista completa de configuraciones regionales compatibles.
* Consulta [`getLocaleProperties`](/docs/node/api/get-locale-properties) para ver los metadatos de la configuración regional.