# 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 确定某个区域设置的文本方向 (从左到右或从右到左) 。
它会返回 `'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'` - 该区域设置的文本方向：

* `'ltr'`：从左到右 (大多数语言) 
* `'rtl'`：从右到左 (阿拉伯语、希伯来语、波斯语、乌尔都语等)

### 抛出的错误

* `Error` - 如果未提供区域设置，且该实例也未配置 `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) 获取区域设置属性
* 通过 [`is-valid-locale`](/docs/core/class/methods/locales/is-valid-locale) 验证区域设置
* 通过 [`get-locale-emoji`](/docs/core/class/methods/locales/get-locale-emoji) 获取区域设置表情符号
* 了解可独立使用的 [`get-locale-direction`](/docs/core/functions/locales/get-locale-direction)