# react-native: getLocaleProperties
URL: https://generaltranslation.com/es/docs/react-native/api/helpers/get-locale-properties.mdx
---
title: getLocaleProperties
description: Referencia de la API del método getLocaleProperties del lado del servidor
---

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. En su lugar, 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, como su nombre, nombre nativo, idioma, región e información sobre el sistema de 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-native/api/helpers/use-locale-properties).

## Referencia

### Parámetros

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

### Devuelve

Un objeto `LocaleProperties` con los siguientes campos:

| Campo                      | Tipo     | Descripción                                                                               |
| -------------------------- | -------- | ----------------------------------------------------------------------------------------- |
| `code`                     | `string` | El código de 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 configuración regional totalmente expandido (p. ej., `'en-Latn-US'`).        |

***

## Ejemplos

### Uso básico

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

export default function LocaleInfo() {
  const props = getLocaleProperties('en-US'); // [!code highlight]
  return (
    <div>
      <p>Nombre: {props.name}</p>
      <p>Nombre nativo: {props.nativeName}</p>
      <p>Región: {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 para mostrar a los usuarios los metadatos de la configuración regional.

## Siguientes pasos

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