---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# i18N - クライアント

# i18N - クライアント {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：1分

i18N API は、翻訳されたメッセージを取得してフォーマットするためのメソッドを提供します。

i18N メソッドには、`g_i18n` グローバルオブジェクトを使用してアクセスします。

## i18N - format(文字列 message, オブジェクトマップ) {#ariaid-title2}

特定のトークンを含む文字列を、マップの値でフォーマットします。
{#r_i18NV3-format_S_O__table_bqg_ngc_mv__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| message | 文字列 | トークンを追加するメッセージ。 |
| map | オブジェクト | メッセージ内で置換する名前と値のペアのマップ。 |
[表 : 1. パラメーター]

{#r_i18NV3-format_S_O__table_bqg_ngc_mv} {#r_i18NV3-format_S_O__table_cqg_ngc_mv__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 書式設定された文字列 |
[表 : 2. 返される内容]

{#r_i18NV3-format_S_O__table_cqg_ngc_mv}  

    // Returns: "The rich young ruler was very very rich"
    nowapi.g_i18n.format("The {p1} {p2} {p3} was very very {p1}",{p1: "rich", p2: "young", p3: "ruler"});

## i18N - getMessage(文字列 msgKey, 関数コールバック) {#ariaid-title3}

翻訳されたメッセージを取得します。
指定された文字列が現在の言語のデータベースに存在する場合、翻訳されたメッセージが返されます。指定された文字列が現在の言語に存在しない場合、英語版の文字列が返されます。文字列がデータベースに存在しない場合は、ID 自体が返されます。
{#r_i18NV3-getMessage_S_F__table_kvv_52c_mv__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| msgKey | 文字列 | 取得するメッセージ。 |
| コールバック | 関数 | メッセージが取得されたときに呼び出される関数。コールバック関数には、翻訳されたメッセージを表す文字列の引数が 1 つ含まれます。 |
[表 : 3. パラメーター]

{#r_i18NV3-getMessage_S_F__table_kvv_52c_mv} {#r_i18NV3-getMessage_S_F__table_lvv_52c_mv__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 4. 返される内容]

{#r_i18NV3-getMessage_S_F__table_lvv_52c_mv}

## i18N - getMessages(配列 msgKeys, 関数 callback) {#ariaid-title4}

一連のメッセージを取得します。
指定された文字列が現在の言語のデータベースに存在する場合、翻訳されたメッセージが返されます。指定された文字列が現在の言語に存在しない場合、英語版の文字列が返されます。文字列がデータベースに存在しない場合は、ID 自体が返されます。
{#r_i18NV3-getMessages_A_F__table_mqm_3hc_mv__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| msgKey | アレイ | 取得するメッセージを指定するキーのアレイ。 |
| callback | 関数 | メッセージが取得されたときに呼び出される関数。コールバック関数には引数が 1 つ含まれます。これはキーと値のペアを含むオブジェクトで、キーは要求されたメッセージキー、値は翻訳された文字列です。 |
[表 : 5. パラメーター]

{#r_i18NV3-getMessages_A_F__table_mqm_3hc_mv} {#r_i18NV3-getMessages_A_F__table_nqm_3hc_mv__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 6. 返される内容]

{#r_i18NV3-getMessages_A_F__table_nqm_3hc_mv}