深入指南
國際化

以 ID 參照地區設定

Angular 使用 Unicode 地區設定識別碼 (Unicode locale ID) 來尋找正確的地區設定資料，以便對文字字串進行國際化。

Unicode 地區設定 ID

地區設定 ID 指定了語言、國家，以及用於進一步變體或細分的選用代碼。 地區設定 ID 由語言識別碼、一個連字號 (-) 字元與地區設定擴充部分組成。

{language_id}-{locale_extension}

HELPFUL: 若要正確翻譯你的 Angular 專案，你必須決定國際化要鎖定的語言與地區設定。

許多國家使用相同語言，但用法有所不同。 這些差異包括文法、標點符號，以及貨幣、小數、日期的格式等等。

本指南的範例使用下列語言與地區設定。

語言 地區設定 Unicode locale ID
英文 加拿大 en-CA
英文 美國 en-US
法文 加拿大 fr-CA
法文 法國 fr-FR

Angular 儲存庫 包含常見的地區設定。

語言代碼清單請見 ISO 639-2。

設定來源地區設定 ID

使用 Angular CLI 設定你撰寫元件範本與程式碼所用的來源語言。

預設情況下，Angular 使用 en-US 作為專案的來源地區設定。

若要為建置變更專案的來源地區設定，請完成下列動作。

  1. 開啟 angular.json 工作區建置設定檔。
  2. 在 i18n 區段中新增或修改 sourceLocale 欄位：
{
  "projects": {
    "your-project": {
      "i18n": {
        "sourceLocale": "ca" // Use your desired locale code
      }
    }
  }
}

在依賴注入之外讀取目前地區設定

在元件或服務內，注入 LOCALE_ID token 即可取得目前使用的地區設定。

若無法注入 LOCALE_ID，例如在注入上下文之外的一般函式中，請讀取 $localize.locale。 每個在地化建置都會設定這個值，預設的 LOCALE_ID 工廠讀取的正是它。 若你的應用程式提供自己的 LOCALE_ID，$localize.locale 不會反映它。

declare const $localize: {locale?: string};

export const locale = (typeof $localize !== 'undefined' && $localize.locale) || 'en-US';

請將這段程式碼放在含有 import 或 export 的檔案中。若你的專案已包含 @angular/localize 型別，請省略 declare 那一行。

下一步