---
title: "array_to_string function in Strata | Oplema"
description: "Join the values in a list into one string using a separator. For example, array_to_string([1, 2, 3], '-') returns '1-2-3'."
url: "https://oplema.com/docs/strata/functions/array-to-string"
updated: "2026-11-04"
---

# array\_to\_string

Join the values in a list into one string using a separator.

## Try an expression

In [Formula](https://oplema.com/docs/strata/prep/formula), enter the expression and set Output type to **VARCHAR**.

### Expression

```
array_to_string([1, 2, 3], '-')
```

### Result

```
'1-2-3'
```

To use your own data, replace the example values with column names. Keep format strings and other options as written.

Try it live in Formula

Result
| id | result |
| --- | --- |
| 1 | 1-2-3 |

## Arguments and types

```
array_to_string(arr, sep)
```

**arr**

Any value

**sep**

Any value

Supported signatures (1)

```
array_to_string(arr: ANY, sep: ANY)
```

The result type can depend on the input types. See DuckDB for the full argument rules.

## Things to know

If the first argument is missing, the result is NULL.

## Related functions

[array\_to\_string\_comma\_default

Join the values in a list into comma-separated text.

](https://oplema.com/docs/strata/functions/array-to-string-comma-default)[list\_approx\_count\_distinct

Calculate an approximate count of distinct values from the values in a list.

](https://oplema.com/docs/strata/functions/list-approx-count-distinct)[list\_avg

Calculate the arithmetic mean from the values in a list.

](https://oplema.com/docs/strata/functions/list-avg)[list\_bit\_and

Calculate the bitwise AND from the values in a list.

](https://oplema.com/docs/strata/functions/list-bit-and)

[Browse lists & arrays](https://oplema.com/docs/strata/functions#lists-&-arrays) [DuckDB documentation](https://duckdb.org/docs/current/sql/functions/list.html#array_to_stringlist-delimiter)

Function metadata from DuckDB, used under the [MIT license](https://github.com/duckdb/duckdb/blob/v1.5.4/LICENSE).
