# gt-react: General Translation React SDK: getLocaleProperties
URL: https://generaltranslation.com/es/docs/react/api/helpers/get-locale-properties.mdx
---
title: getLocaleProperties
description: Referencia de la API para el método getLocaleProperties del lado del servidor
---

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. Edita la plantilla en content/docs-templates/. */}


## Resumen

La función `getLocaleProperties` devuelve metadatos sobre una configuración regional especificada durante el renderizado del lado del servidor, incluidos su nombre, nombre nativo, idioma, región e información de la escritura.

<Callout>
  `getLocaleProperties` es un método del lado del servidor y solo puede usarse en componentes del servidor.
</Callout>

Para usarlo del lado del cliente, consulta [`useLocaleProperties`](/docs/react/api/helpers/use-locale-properties).

## Referencia

### Parámetros

| Parámetro | Tipo     | Descripción                                                                   |
| --------- | -------- | ----------------------------------------------------------------------------- |
| `locale`  | `string` | Un código de configuración regional según BCP 47 (p. ej., `'en-US'`, `'ja'`). |

### Valor devuelto

Un objeto `LocaleProperties` con los siguientes campos:

| Campo                      | Tipo     | Descripción                                                                               |
| -------------------------- | -------- | ----------------------------------------------------------------------------------------- |
| `code`                     | `string` | El código de la configuración regional (p. ej., `'en-US'`).                               |
| `name`                     | `string` | El nombre en inglés de la configuración regional (p. ej., `'American English'`).          |
| `nativeName`               | `string` | El nombre en el idioma de la configuración regional (p. ej., `'American English'`).       |
| `languageCode`             | `string` | La subetiqueta de idioma (p. ej., `'en'`).                                                |
| `languageName`             | `string` | El nombre en inglés del idioma (p. ej., `'English'`).                                     |
| `nativeLanguageName`       | `string` | El nombre del idioma en su propio idioma (p. ej., `'English'`).                           |
| `nameWithRegionCode`       | `string` | El nombre de la configuración regional con la región incluida (p. ej., `'English (US)'`). |
| `nativeNameWithRegionCode` | `string` | El nombre nativo de la configuración regional con la región incluida.                     |
| `regionCode`               | `string` | La subetiqueta de región (p. ej., `'US'`).                                                |
| `regionName`               | `string` | El nombre en inglés de la región (p. ej., `'United States'`).                             |
| `nativeRegionName`         | `string` | El nombre de la región en el idioma de la configuración regional.                         |
| `scriptCode`               | `string` | La subetiqueta del sistema de escritura (p. ej., `'Latn'`).                               |
| `scriptName`               | `string` | El nombre en inglés del sistema de escritura (p. ej., `'Latin'`).                         |
| `nativeScriptName`         | `string` | El nombre del sistema de escritura en el idioma de la configuración regional.             |
| `maximizedCode`            | `string` | El código de la configuración regional completamente expandido (p. ej., `'en-Latn-US'`).  |

***

## Ejemplos

### Uso básico

```jsx title="LocaleInfo.jsx" copy
import { getLocaleProperties } from 'gt-react/server';

export default function LocaleInfo() {
  const props = getLocaleProperties('en-US'); // [!code highlight]
  return (
    <div>
      <p>Name: {props.name}</p>
      <p>Native name: {props.nativeName}</p>
      <p>Region: {props.regionName}</p>
    </div>
  );
}
```

***


## Notas

* Esta función es sincrónica: no es necesario usar `await`.
* Es útil para crear selectores de configuración regional o mostrar metadatos de configuración regional a los usuarios.

## Próximos pasos

* Consulta [`useLocaleProperties`](/docs/react/api/helpers/use-locale-properties) para ver el equivalente del lado del cliente.
* Obtén más información sobre los [códigos de configuración regional](/docs/core/locales).