字符串格式器

根据可自定义的规则修改一个或多个值的格式。

字符串格式器可用于：

在某个值前后添加字符（如果源变量的值为数值）。

将 SQL 查询格式化和参数化以用于数据库对象。

将一系列字符串链接在一起。

应用数字格式（如小数位数或浮点四舍五入）。

属性

属性	说明
格式	变量引用格式设置规则：索引。用于标识输入变量的索引编号。对于格式设置规则中的每个 {index} 占位符，将显示一个指示源的新字段。对齐。一个整数，表示根据规则格式化的源值的字符数。格式。要应用于输入变量的格式。格式占位符接受 String.Format 方法的 .NET Framework 表示法所需的值子集。占位符必须使用语法 {index,alignment:format} 。
模式	动态链接的方向：从源节点读取到父节点。从父节点写入源节点。从源节点读取到父节点，从父节点写入源节点。

说明

格式

变量引用格式设置规则：

索引
。用于标识输入变量的索引编号。对于格式设置规则中的每个

{index}

占位符，将显示一个指示源的新字段。

对齐
。一个整数，表示根据规则格式化的源值的字符数。

格式
。要应用于输入变量的格式。

格式占位符接受

String.Format

方法的 .NET Framework 表示法所需的值子集。占位符必须使用语法

{index,alignment:format}

。

模式

动态链接的方向：

从源节点读取到父节点。

从父节点写入源节点。

从源节点读取到父节点，从父节点写入源节点。

源

源是一个或多个变量，由带有

{index number}

的占位符标识。索引编号是递进的，它必须是大于零

{0}

的整数。可按任意顺序在格式设置规则中使用占位符。例如，

the minimum value of {3}, {0} and {2} is {1}

是有效的语法。

可以在格式设置字符串

{index,alignment:format}

中嵌套占位符，以动态更改所显示数据的格式。

嵌套的占位符示例：

{0:f{1}}: 与
{1}
链接的变量值定义小数位数。
{0:{1}{2}}: 与
{1}
链接的变量值定义数字数据类型。
与
{2}
链接的变量值定义小数位数。
{0,{1}:{2}{3}}: 与
{1}
链接的变量值定义对齐方式。
与
{2}
链接的变量值定义数字数据类型。
与
{3}
链接的变量值定义小数位数。

数据类型

示例数据：23/04/2021 17:25:31, session with 60 minutes TimeZone offset。

DateTime
格式	说明	示例
g	短日期和时间，本地	(en-US)：4/23/21, 06:25 PM (it-IT)：23/04/21, 18:25
F	长日期和时间，本地	(en-US)：Apr 23, 2021, 6:25:31 PM (it-IT)：23 apr 2021, 18:25:31
X	短日期和时间，UTC	(en-US)：4/23/21, 4:25 PM (UTC) (it-IT)：23/04/21, 16:25 (UTC)
x	长日期和时间，UTC	(en-US)：Apr 23, 2021, 4:25:31 PM (UTC) (it-IT)：23 apr 2021, 16:25:31 (UTC)
U	完整的通用日期和时间，UTC	(en-US)：April 23, 2021 4:25:31 PM GMT (UTC) (it-IT)：23 aprile 2021 16:25:31 GMT (UTC)
p	短日期，本地	(en-US)：4/23/21 (it-IT)：23/04/21
P	长日期，本地	(en-US)：April 23, 2021 (it-IT)：23 apr 2021
d	短日期，UTC	(en-US)：4/23/21 (UTC) (it-IT)：23/04/21 (UTC)
D	长日期，UTC	(en-US)：Apr 23, 2021 (UTC) (it-IT)：23 apr 2021 (UTC)
t	短时间，本地	(en-US)：6:25 PM (it-IT)：18:25
T	长时间，本地	(en-US)：6:25:31 PM (it-IT)：18:25:31
h	短时间，UTC	(en-US)：4:25 PM (UTC) (it-IT)：16:25 (UTC)
H	长时间，UTC	(en-US)：4:25:31 PM (UTC) (it-IT)：16:25:31 (UTC)

数字 (Double Float Int16 Int32 Int64 Integer UInt16 UInt32 UInt64 UInteger)
格式	说明	示例
d	不含千位分隔符的数值。在格式占位符后面，用整数配置小数位数（不填零）。	d : -1234 ► -1234 d : 5.618 ► 5618 d2 : 1,234.239 ► 1234.24
n	含千位分隔符的数值。在格式占位符后面，用整数配置小数位数（不填零）。	n1 : -1234.23 ► -1,234.2 n2 : 5804.236 ► 5,804.24 n3 : -1234.23 ► -1234.230
e	指数表示法。在格式占位符后面，用整数配置有效数字的个数。	e10 : 12345.6789 ► 1.234567890E4 e2 : 2665.778 ► 2.7E3
f	固定点表示法。在格式占位符后面，用整数配置小数位的确切个数。	f3 : 123 ► 123.000 f3 : 123.23 ► 123.230 f4 : -1898300.678 ► -1,898,300.6780 f3 : 123.4 ► 123.400
p	百分比。在格式占位符后，用整数配置小数位数。	p : 1 ► 100% p3 : -0.397481 ► -39.748%
x	十六进制表示法。	255 ► ff
b	二进制表示法。	107 ► 1101011
o	八进制表示法。	56 ► 70

持续时间和时间跨度
格式	说明	示例
c	常量格式。	3.17:25:30.5000000 4:30:00 AM
g	常规短格式。	(en-US)：1:3:16:50.5 (en-US)：5:15:09:00 (fr-FR): 2:9:02:00,0200000 (fr-FR): 15:12:20:00 (en-US)：5:12:00 (fr-FR): 20:10:00
G	扩展通用格式。	(en-US)：12:08:30 AM:00.0000000 (fr-FR): 12:08:30 AM:00.0000000 (en-US)：12:18:20 AM:00.0000000 (fr-FR): 12:17:30 AM:00.0000000

字符串
格式	说明	示例
l	全部小写。	grüßEN ► grüßen
u	全部大写。	grüßEN ► GRÜSSEN
t	所有首字母大写。	grüßEN ► GRÜSSEN
f	不区分大小写。	grüßEN ► grüssen

ANSI SQL
格式	说明	示例
sql_identifier	将给定 String 或 LocalizedText 的格式设置为表或列标识符。	-
sql_literal	将变量值的格式设置为 SQL 文本值（数字、字符串、日期、时间等）。	-

SQL 查询示例

在以下条件下将内部列的名称参数化：

SELECT * FROM Table1 WHERE {0:sql_identifier} > 5

与数据变量的比较：

SELECT * FROM AlarmsDatalogger WHERE Time > {0:sql_literal}

将

运算符参数化：

SELECT * FROM AlarmsDatalogger WHERE Name LIKE '{0}'

使用占位符将查询的一部分参数化：

SELECT * FROM Table1 {0}

具有索引

的占位符链接到项目字符串变量并将一列参数化；具有索引

的占位符链接到一个数值变量，该变量表示比较运算符

的值：

SELECT * FROM {0:sql_identifier} WHERE Column1 > {1:sql_literal}

将表名、列和

运算符参数化：

SELECT {0:sql_identifier} FROM {1:sql_identifier} WHERE {0:sql_identifier} LIKE '{2}'

路径格式设定

请考虑以下路径格式设置功能：

要将字符串格式化为文件路径，可以使用以下语法：

{index,alignment:filepath
}

。

输入: ns=5;%PROJECTDIR%/Logo.svg
输出: C:\Users\UserName\AppData\Local\Rockwell Automation\FactoryTalk Optix\Emulator\Projects\ProjectName\ProjectFiles\Logo.svg

要将字符串格式化为 URI，可以使用以下语法：

{index,alignment:uri
}

。

输入: ns=5;%PROJECTDIR%/Logo.svg
输出: file:///C:/Users/UserName/AppData/Local/Rockwell Automation/FactoryTalk Optix/Emulator/Projects/ProjectName/ProjectFiles/Logo.svg

要格式化路径的一部分，可以使用以下语法：

file:///C:/Reports/Report
{0}
.pdf

。

反向格式设置

反向格式设置功能允许您在运行时修改带格式的值，将该值替换为应用程序在运行时以相同格式显示的新值。

必须进行以下设置，反向格式设置功能置才能正常运行：

转换器的动态链接

模式

必须为

读/写

。

格式

字段只能有一个占位符或源。占位符可以具有后缀和/或前缀，并用格式字符串（如

{0:n}

）进行设置。

输出

在

格式

属性中输入的字符串，基于用值来代替占位符的格式设置规则。

示例

转换器

提供反馈

对本文档有问题或反馈吗？请在这里提交您的反馈。