# General Translation React SDKs (gt-react, gt-next, gt-react-native): getLocale
URL: https://generaltranslation.com/es/docs/react/nextjs/reference/functions/get-locale.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Lee la configuración regional de la solicitud actual del App Router de Next.js con General Translation. Referencia de la API de getLocale.

La función `getLocale` devuelve la configuración regional de la solicitud actual del App Router como un código de configuración regional BCP 47. Impórtala desde `gt-next/server` en componentes async, Route Handlers y otro código del servidor.

`getLocale` es solo para el servidor y no funciona con el Pages Router.

## Descripción general [#overview]

```tsx
import { getLocale } from 'gt-next/server';

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

## Devuelve [#returns]

**Tipo** `Promise<string>`

Una promesa que se resuelve con la configuración regional de la solicitud actual. General Translation determina la configuración regional mediante la función configurada para la configuración regional de la solicitud y recurre a la configuración regional predeterminada cuando es necesario.

## Comportamiento ante configuraciones regionales no válidas [#invalid-locales]

Cuando la configuración regional de la solicitud no es compatible, `gt-next` muestra una advertencia y devuelve `defaultLocale`. Configura [`disableInvalidLocaleWarning`](/docs/react/nextjs/config#disable-invalid-locale-warning) para suprimir la advertencia sin cambiar el contenido alternativo.

En una ruta `[locale]` estricta, comprueba el parámetro de ruta con [`isLocaleSupported`](/docs/react/nextjs/reference/functions/is-locale-supported) y llama a `notFound()` de Next.js antes de renderizar. `getLocale` no genera un 404 automáticamente.

## Ejemplo [#example]

```tsx title="app/[locale]/layout.tsx"
import { getLocale } from 'gt-next/server';

export default async function LocaleLayout({ children }) {
  const locale = await getLocale();
  return <html lang={locale}>{children}</html>;
}
```

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
