# TextФункция скрипта и диаграммы

Text() преобразует выражение в текстовый вид даже при возможности обработки его в качестве числа.

Синтаксис:

Text (expr)

Возвращаемые типы данных: строка

Аргументы

| Аргумент | Описание |
| --- | --- |
| expr | Выражение, которое будет рассматриваться как текст. |

Пример: выражения диаграммы

| Пример | Результаты |
| --- | --- |
| `Text( 1234 )` | Возвращает `1234` как строку. Числовое значение отсутствует. |
| `Text( pi( ) )` | Возвращает `3.1415926535898` как строку. Числовое значение отсутствует. |

## Пример. Основы использования функции Text

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/Text.htm)

#### Скрипт загрузки

Обзор

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.

Скрипт загрузки содержит следующее:

* Набор данных, который загружается в таблицу данных под именем `Example`.

* Следующие поля в таблице данных:

  * `ID`

  * `PostalCode`

* Предшествующая загрузка, которая использует функцию `Text` для создания нового поля с именем `PostalCode_Text`, чтобы почтовые индексы оставались в виде текста и не преобразовывались в числа.

Скрипт загрузки

```
Example:
LOAD
ID,
PostalCode,
Text(PostalCode) AS PostalCode_Text;
LOAD * INLINE [
ID, PostalCode
1, 12345
2, 54321
3, 67890
4, 11223
5, 33445
];
```

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:

* `ID`

* `PostalCode`

* `PostalCode_Text`

Results table

Results table

| ID | PostalCode | PostalCode\_Text |
| --- | --- | --- |
| 1 | 12345 | 12345 |
| 2 | 54321 | 54321 |
| 3 | 67890 | 67890 |
| 4 | 11223 | 11223 |
| 5 | 33445 | 33445 |

В выводе предшествующей загрузки используется функция `Text` для того, чтобы числовые значения обрабатывались как текст. Видно, что значения в столбце `PostalCode_Text` обрабатываются как текст и по умолчанию выравниваются влево, а значения в столбце `PostalCode` ― это числа и по умолчанию выравниваются вправо.

## Пример. Сценарий использования функции Text

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/Text.htm)

#### Скрипт загрузки

Обзор

Набор данных содержит данные о счетах-фактурах клиентов, которые вводятся в виде числовых значений, но требуется сохранить эти значения в виде текста.

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.

Скрипт загрузки содержит следующее:

* Набор данных, который загружается в таблицу данных под именем `Example`.

* Следующие поля в таблице данных:

  * `InvoiceNumber`

  * `CustomerName`

* Предшествующая загрузка, которая использует функцию `Text` для создания нового поля с именем `InvoiceNumber_Text`, чтобы номера счетов-фактур обрабатывались как текст.

Скрипт загрузки

```
Example:
LOAD
InvoiceNumber,
CustomerName,
Text(InvoiceNumber) AS InvoiceNumber_Text;
LOAD * INLINE [
InvoiceNumber, CustomerName
10001, John Doe
10002, Jane Smith
10003, Bob Johnson
10004, Alice Brown
10005, Michael Green
];
```

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:

* `InvoiceNumber`

* `CustomerName`

* `InvoiceNumber_Text`

Results table

Results table

| InvoiceNumber | CustomerName | InvoiceNumber\_Text |
| --- | --- | --- |
| 10001 | John Doe | 10001 |
| 10002 | Jane Smith | 10002 |
| 10003 | Bob Johnson | 10003 |
| 10004 | Alice Brown | 10004 |
| 10005 | Michael Green | 10005 |

Результаты показывают, что числовые значения в столбце `InvoiceNumber` теперь преобразованы в текстовые значения в столбце `InvoiceNumber_Text` и выровнены по левому краю.