# generaltranslation: General Translation Core SDK: getLocaleDirection
URL: https://generaltranslation.com/zh/docs/core/class/methods/locales/get-locale-direction.mdx
---
title: getLocaleDirection
description: GT getLocaleDirection 方法的 API 参考
---

## 概览

`getLocaleDirection` 方法使用 `Intl.Locale` API 判定某个 locale 的文本方向（从左到右或从右到左）。
它会返回 `'ltr'`（适用于从左到右的语言）或 `'rtl'`（适用于从右到左的语言）。

```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”
```

***


## 参考资料

### 参数

<TypeTable
  type={{
    "locale?": {
      type: 'string',
      optional: true,
      default: 'this.targetLocale',
    }
  }}
/>

### 参数说明

| 参数 | 说明 |
|-----------|-------------|
| `locale` | 用于检查文本方向的 BCP-47 语言代码。若未提供，则使用该实例的 `targetLocale`。 |

### 返回值

`'ltr' | 'rtl'` - 该 locale 的文本方向：

- `'ltr'`：从左到右（多数语言）
- `'rtl'`：从右到左（阿拉伯语、希伯来语、波斯语、乌尔都语等）

### 抛出

- `Error` - 当未提供 locale 且该实例未配置 `targetLocale` 时

---

## 示例

```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"
```

***


## 说明

- 对所有从左到右书写的语言（全球大多数语言）返回 `'ltr'`
- 对从右到左书写的语言（阿拉伯语、希伯来语、波斯语等）返回 `'rtl'`

## 后续步骤

- 使用 [`get-locale-properties`](/docs/core/class/methods/locales/get-locale-properties) 获取 locale 属性
- 使用 [`is-valid-locale`](/docs/core/class/methods/locales/is-valid-locale) 校验 locales
- 使用 [`get-locale-emoji`](/docs/core/class/methods/locales/get-locale-emoji) 获取 locale 的 emoji
- 了解独立函数 [`get-locale-direction`](/docs/core/functions/locales/get-locale-direction)