# General Translation Platform: getLocaleDirection
URL: https://generaltranslation.com/es/docs/platform/core/reference/utility-functions/locales/get-locale-direction.mdx
---

title: getLocaleDirection
description: Devuelve la dirección del texto de una configuración regional sin una instancia de GT. Referencia de la API para getLocaleDirection.

---

[`getLocaleDirection`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-direction) es una función de utilidad independiente de la biblioteca Core de General Translation que devuelve la dirección del texto —de izquierda a derecha o de derecha a izquierda— de una configuración regional. Se usa principalmente para establecer el atributo `dir` de un elemento HTML según la configuración regional.

## Descripción general [#overview]

Importa `getLocaleDirection` directamente desde `generaltranslation` y llámalo con un código de configuración regional. No requiere una clave de API ni una instancia de [GT](/docs/platform/core/reference/gt-class/constructor). Para la versión equivalente basada en instancias, usa el método [`getLocaleDirection`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-direction) en una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

const direction = getLocaleDirection('ar-SA');
console.log(direction); // "rtl"

const englishDirection = getLocaleDirection('en-US');
console.log(englishDirection); // "ltr"
```

Firma:

```typescript
getLocaleDirection(locale: string): 'ltr' | 'rtl'
```

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

La función usa la propiedad `textInfo.direction` de la API `Intl.Locale`:

1. Crea un objeto `Intl.Locale` para la configuración regional proporcionada.
2. Lee la propiedad `textInfo.direction` para obtener la dirección correspondiente al idioma.
3. Devuelve `'rtl'` para los idiomas de derecha a izquierda y `'ltr'` para todos los demás.
4. Usa `'ltr'` de forma predeterminada si la configuración regional no es válida o si se produce un error.

### Reconocimiento de idiomas de derecha a izquierda

Detecta automáticamente idiomas de derecha a izquierda, incluidos:

* **Árabe** (`ar`, `ar-SA`, `ar-EG`, `ar-AE` y otros)
* **Hebreo** (`he`, `he-IL`)
* **Persa/Farsi** (`fa`, `fa-IR`)
* **Urdu** (`ur`, `ur-PK`, `ur-IN`)
* **Pastún** (`ps`)
* **Sindhi** (`sd`)
* **Kurdo soraní** (`ckb`)
* Y otros sistemas de escritura de derecha a izquierda.

### Manejo de errores

* Los códigos de configuración regional no válidos o mal formados usan `'ltr'` de forma predeterminada.
* No se lanzan excepciones si la entrada no es válida.

## Parámetros [#parameters]

| Parámetro           | Descripción                                                                    | Tipo     | Opcional | Predeterminado |
| ------------------- | ------------------------------------------------------------------------------ | -------- | -------- | -------------- |
| [`locale`](#locale) | Código de configuración regional BCP-47 para consultar la dirección del texto. | `string` | No       | —              |

### `locale` [#locale]

**Tipo** `string` · **Obligatorio**

El código de configuración regional BCP-47 para consultar la dirección del texto.

## Devuelve [#returns]

**Tipo** `'ltr' | 'rtl'`

La dirección del texto de la configuración regional:

* `'ltr'`: de izquierda a derecha (la mayoría de los idiomas, incluidos el inglés, el español, el francés, el alemán, el chino y el japonés).
* `'rtl'`: de derecha a izquierda (árabe, hebreo, persa, urdu y otros idiomas semíticos o de Oriente Medio).

## Ejemplos [#examples]

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

// Idiomas de izquierda a derecha
console.log(getLocaleDirection('en-US')); // "ltr"
console.log(getLocaleDirection('es-ES')); // "ltr"
console.log(getLocaleDirection('fr-FR')); // "ltr"
console.log(getLocaleDirection('ja-JP')); // "ltr"
console.log(getLocaleDirection('zh-CN')); // "ltr"

// Idiomas de derecha a izquierda
console.log(getLocaleDirection('ar-SA')); // "rtl"
console.log(getLocaleDirection('he-IL')); // "rtl"
console.log(getLocaleDirection('fa-IR')); // "rtl"
console.log(getLocaleDirection('ur-PK')); // "rtl"
```

## Notas [#notes]

* Devuelve `'ltr'` para todos los idiomas de izquierda a derecha (la mayoría de los idiomas del mundo).
* Devuelve `'rtl'` para los idiomas de derecha a izquierda (árabe, hebreo, persa y otros).
* Usa la API moderna `Intl.Locale` para detectar la dirección con precisión.
* Funciona con todos los códigos de configuración regional BCP-47.