# General Translation Platform: getLocaleDirection
URL: https://generaltranslation.com/ru/docs/platform/core/reference/gt-class-methods/locales/get-locale-direction.mdx
---

title: getLocaleDirection
description: Возвращает направление текста для локали. Справочник API по getLocaleDirection.

---

Определяет направление текста для локали в экземпляре [GT](/docs/platform/core/reference/gt-class/constructor) с помощью API `Intl.Locale`. General Translation возвращает `'ltr'` для языков с написанием слева направо и `'rtl'` для языков с написанием справа налево.

## Обзор [#overview]

Вызовите `getLocaleDirection` у экземпляра [`GT`](/docs/platform/core/reference/gt-class/constructor), при необходимости передав код локали. Если его не указать, будет использоваться `targetLocale` этого экземпляра.

```typescript
const gt = new GT({ sourceLocale: 'en', targetLocale: 'ar' });

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

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

Сигнатура:

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

*Примечание: `getLocaleDirection` выполняется локально с помощью `Intl.Locale` и не требует API-ключа. Если параметр `locale` не указан, используется `targetLocale` экземпляра. О поиске без экземпляра `GT` см. в описании автономной [`getLocaleDirection`](/docs/platform/core/reference/utility-functions/locales/get-locale-direction).*

## Как это работает [#how-it-works]

* **Определение направления.** Возвращает `'ltr'` для языков с написанием слева направо (большинства языков мира) и `'rtl'` для языков с написанием справа налево (арабского, иврита, персидского, урду и других).
* **Резервная локаль.** Если `locale` не указана, используется `targetLocale` этого экземпляра.
* **Локаль не указана.** Вызывает `Error`, если локаль не передана и для экземпляра не настроен `targetLocale`.

## Параметры [#parameters]

| Параметр            | Описание                                                            | Тип      | Необязательный | По умолчанию        |
| ------------------- | ------------------------------------------------------------------- | -------- | -------------- | ------------------- |
| [`locale`](#locale) | Код локали BCP-47, для которой нужно определить направление текста. | `string` | Да             | `this.targetLocale` |

### `locale` [#locale]

**Тип** `string` · **Необязательно** · **По умолчанию** `this.targetLocale`

Код локали BCP-47, для которой определяется направление текста. Если не указан, используется `targetLocale` этого экземпляра.

## Возвращает [#returns]

**Тип** `'ltr' | 'rtl'`

Направление текста для локали:

* `'ltr'`: слева направо (большинство языков).
* `'rtl'`: справа налево (арабский, иврит, персидский, урду и т. д.).

Выбрасывает `Error`, если локаль не указана и для экземпляра не задан `targetLocale`.

## Примеры [#examples]

```typescript
const gt = new GT({ sourceLocale: 'en', targetLocale: 'ar' });

// Проверка направлений письма для разных языков
console.log(gt.getLocaleDirection()); // "rtl" (использует targetLocale 'ar')
console.log(gt.getLocaleDirection('en')); // "ltr"
console.log(gt.getLocaleDirection('ar')); // "rtl"
console.log(gt.getLocaleDirection('he')); // "rtl"
console.log(gt.getLocaleDirection('fa')); // "rtl"
console.log(gt.getLocaleDirection('fr')); // "ltr"
```

## Заметки [#notes]

* Возвращает `'ltr'` для всех языков с написанием слева направо (это большинство языков мира).
* Возвращает `'rtl'` для языков с написанием справа налево (арабский, иврит, персидский и т. д.).