# 将数值型转换为字符串型

将数字值（十进制或十六进制）转换为字符串。

[Source Data]中的数字将转换为[Source Data Format]中指定数据格式（十进制或十六进制）的字符串，并存储在[Destination Data]中。

##### 块

##### 文本

TARGET = toString(EXPRESSION, 10, 0);
1 5 2 3/4

# | 描述
1 | [Destination Data] 设置目标以存储转换后的字符串。
2 | [Source Data Format] 选择以下格式之一： ##### 块 [Decimal]: 将十进制数字转换为字符串。 [Hex]: 将十六进制数字转换为字符串。 ##### 文本 '10': 将十进制数字转换为字符串。 '16': 将十六进制数字转换为字符串。
3 | [Zero Suppress] ##### 块 选择复选框，以禁止在数值前面显示零。清除复选框，指定 [Integer Digits] 的数量，并在数值前面添加零以与位数对齐。
(示例) [Source Data]: 25, [Integer Digits]: 4
选中复选框（启用）时： | 25
清除复选框（禁用）时： | 0025
##### 文本 设置 '0’ 以禁止在数值前面显示零。设置一个介于 '1’ 至 '20’ 之间的数值，指定 [Integer Digits] 的数量，并在数值前面添加零以与位数对齐。
(示例) [Source Data]: 25
[Integer Digits]: 0 | 25
[Integer Digits]: 4 | 0025
4 | [Integer Digits] 指定要转换的字符串中的位数。设置值范围: 1 - 20 当 [脚本模式] 为 [块]， [Zero Suppress] 复选框被清除时，设置此值。
5 | [Source Data] 设置源数据，存储要转换的数字。

(示例)

##### 块

##### 文本

Var3=toString(Var1,10,0);

## 操作示例

[Source Data]中的变量 | [Zero Suppress] | [Integer Digits] | [Destination Data]中的变量 | 注解
数据类型和值 | 格式 | 最大字节数 | 转换后字符串
INT: 100 (0x64) | Decimal | 启用 | - | 5 | 100 | -
- | 1 | (无) | 由于转换后的字符串已超过可以存储的最大字节数，未存储字符串。在“操作结果”操作中判断为失败。
禁用 | 4 | 5 | 0100 | 添加“0”以与在 [Integer Digits]中指定的位数对齐。
2 | 5 | 100 | 即使值超过[Integer Digits],也要设置转换后的字符串。
6 | 5 | (无) | 由于转换后的字符串已超过可以存储的最大字节数，未存储字符串。在“操作结果”操作中判断为失败。
6 | 使用[变量长度] | 000100 | 添加“0”以与在 [Integer Digits]中指定的位数对齐。
Hex | 启用 | - | 5 | 64 | -
- | 1 | (无) | 由于转换后的字符串已超过可以存储的最大字节数，未存储字符串。在“操作结果”操作中判断为失败。
禁用 | 4 | 5 | 0064 | 添加“0”以与在 [Integer Digits]中指定的位数对齐。
6 | 使用[变量长度] | 000064 | 添加“0”以与在 [Integer Digits]中指定的位数对齐。
INT: -100 (0xFF9C) | Decimal | 启用 | - | 5 | -100 | "-”支持减号。
禁用 | 4 | 5 | -0100 | "-”支持减号。
Hex | 启用 | - | 5 | FF9C | -
REAL: 100.00 | Decimal | 启用 | - | 5 | 100 | 仅整数部分被转换。
Hex | 启用 | - | 5 | 64 | 仅整数部分被转换。
REAL: 100.678 | Decimal | 启用 | - | 5 | 100 | 仅整数部分被转换。
BOOL: true | - | - | - | 5 | True | -
BOOL: false | - | - | - | 5 | False | -

注： 即使将以下日期类型值之一设置为 [Source Data]，该值也不会从日期/时间格式转换为字符串。该值从整数格式转换为字符串。

- DATE
- TIME
- TIME_OF_DAY
- DATE_AND_TIME

### (示例) DATE_AND_TIME 变量

日期 / 时间格式: 8/19/2020 10:19:00 AM

整数格式 ([Source Data Format]: [Dec]): 1597799940

整数格式 ([Source Data Format]: [Hex]): 5F3C7E04