# 将浮点型转换为字符串型

将实数转换为字符串。

[Source Data]中的实数，基于[Source Float Decimal Places]中指定的小数位数，将转换为字符串并存储在 [Destination Data]中。

##### 块

##### 文本

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

# | 描述
1 | [Destination Data] 设置目标以存储转换后的字符串。
2 | [Source Float Decimal Places] 指定要转换的小数位数。 设置值范围: 0 - 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=floatToString(Var2,0,1);

## 操作示例

[Source Data]中的变量 | [Source Float Decimal Places] | [Zero Suppress] | [Integer Digits] | [Destination Data]中的变量 | 注解
数据类型和值 | 最大字节数 | 转换后字符串
REAL: 1.2345 | 2 | 启用 | - | 5 | 1.23 | -
- | 1 | (无) | 由于转换后的字符串已超过可以存储的最大字节数，未存储字符串。在“操作结果”操作中判断为失败。
禁用 | 3 | 6 | 001.23 | 添加“0”以与在 [Integer Digits]中指定的位数对齐。
4 | 6 | (无) | 由于转换后的字符串已超过可以存储的最大字节数，未存储字符串。在“操作结果”操作中判断为失败。
4 | 使用[变量长度] | 0001.23 | 添加“0”以与在 [Integer Digits]中指定的位数对齐。
0 | 启用 | - | 5 | 1 | -
REAL: 1.2367 | 2 | 启用 | - | 5 | 1.24 | 值已四舍五入。
REAL: -1.2345 | 2 | 启用 | - | 5 | -1.23 | "-”支持减号。
禁用 | 2 | 6 | -01.23 | 添加“0”以与在 [Integer Digits]中指定的位数对齐。
3 | 6 | (无) | 由于转换后的字符串已超过可以存储的最大字节数，未存储字符串。在“操作结果”操作中判断为失败。
0 | 启用 | - | 5 | -1 | -
INT: 10 | 2 | 启用 | - | 5 | 10.00 | 仅整数部分被转换。

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

- DATE
- TIME
- TIME_OF_DAY
- DATE_AND_TIME

### (示例) DATE_AND_TIME 变量

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

实数格式 ([Source Float Decimal Places]: 1): 1597799940.0