---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

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(문자열 메시지, 객체 맵) {#ariaid-title2}

맵의 값이 있는 명명된 토큰이 포함된 문자열의 서식을 지정합니다.
{#r_i18NV3-format_S_O__table_bqg_ngc_mv__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 메시지 | 문자열 | 토큰을 추가할 메시지입니다. |
| 맵 | 객체 | 메시지에서 바꿀 이름/값 쌍의 맵입니다. |
[표 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}

| 이름 | 유형 | 설명 |
|-|-|-|
| 메시지 키 | 문자열 | 검색할 메시지입니다. |
| 콜백 | 기능 | 메시지가 검색될 때 호출할 함수입니다. 콜백 함수에는 하나의 인수, 즉 번역된 메시지인 문자열이 있습니다. |
[표 3. 매개변수]

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

| 유형 | 설명 |
|-|-|
| void |   |
[표 4. 반환]

{#r_i18NV3-getMessage_S_F__table_lvv_52c_mv}

## i18N - getMessages(배열 msgKeys, 함수 콜백) {#ariaid-title4}

메시지 집합을 검색합니다.
지정된 문자열이 현재 언어의 데이터베이스에 있으면 번역된 메시지가 리턴됩니다. 현재 언어에 대해 지정된 문자열이 없으면 영어 버전의 문자열이 반환됩니다. 문자열이 데이터베이스에 전혀 없으면 ID 자체가 반환됩니다.
{#r_i18NV3-getMessages_A_F__table_mqm_3hc_mv__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 메시지 키 | 배열 | 검색할 메시지를 지정하는 키의 배열입니다. |
| 콜백 | 기능 | 메시지가 검색될 때 호출할 함수입니다. 콜백 함수에는 키-값 쌍을 포함하는 객체인 하나의 인수가 있으며, 여기서 key는 요청된 메시지 키이고 값은 번역된 문자열입니다. |
[표 5. 매개변수]

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

| 유형 | 설명 |
|-|-|
| void |   |
[표 6. 반환]

{#r_i18NV3-getMessages_A_F__table_nqm_3hc_mv}