# ARRAYTOTEXT

## Content

이 함수는 배열을 텍스트 문자열로 변환합니다.

## 구문

```auto
ARRAYTOTEXT(array, [format])
```

## 인수

| 인수 | 설명 |
| --- | --- |
| array | 변환할 배열 또는 범위입니다. |
| format | 선택 사항입니다. 출력 형식을 지정합니다.<ul><li>`0` — 간결 형식(기본값)</li><li>`1` — 엄격 형식</li></ul> |

## 반환 값

지정한 배열의 텍스트 표현을 반환합니다.

## 설명

* 생략하면 `format`의 기본값은 `0`입니다.
* 배열의 각 요소는 `VALUETOTEXT`와 동일한 규칙을 사용하여 변환됩니다.
* 출력은 셀 서식과 관계없이 일반(General) 형식을 기준으로 합니다.
* 간결 형식(`0`)에서는:
    * 값이 쉼표로 구분된 목록으로 반환됩니다.
    * 그룹 구분 기호는 현재 문화권 설정을 따릅니다.
* 엄격 형식(`1`)에서는:
    * 결과가 중괄호 `{}` 로 둘러싸입니다.
    * 열은 쉼표로 구분됩니다.
    * 행은 세미콜론으로 구분됩니다.
    * 텍스트 값은 따옴표로 묶이고 이스케이프 처리됩니다.
* 지역화된 텍스트는 현재 문화권 설정에 따라 달라집니다.

## 예제

A1:B3 범위가 다음과 같다고 가정합니다.

| TRUE | #VALUE! |
| ---- | ------- |
| 1234.01234 | Seattle |
| Hello | $1,123.00 |

### 간결 형식

```auto
=ARRAYTOTEXT(A1:B3,0)
```

결과:

```auto
TRUE, #VALUE!, 1234.01234, Seattle, Hello, 1123
```

### 엄격 형식

```auto
=ARRAYTOTEXT(A1:B3,1)
```

결과:

```auto
'{TRUE,#VALUE!;1234.01234,"Seattle";"Hello",1123}'
```

## 참고 항목

* [VALUETOTEXT](/spreadjs/docs/v19/formulareference/FormulaFunctions/text-functions/valuetotext)
* [TEXT](/spreadjs/docs/v19/formulareference/FormulaFunctions/text-functions/TEXT)
* [T](/spreadjs/docs/v19/formulareference/FormulaFunctions/text-functions/T)
* [VALUE](/spreadjs/docs/v19/formulareference/FormulaFunctions/text-functions/VALUE)