字符串格式器

根据可自定义的规则修改一个或多个值的格式。
字符串格式器可用于:
  • 在某个值前后添加字符(如果源变量的值为数值)。
  • 将 SQL 查询格式化和参数化以用于数据库对象。
  • 将一系列字符串链接在一起。
  • 应用数字格式(如小数位数或浮点四舍五入)。

属性

属性
说明
格式
变量引用格式设置规则:
  • 索引
    。用于标识输入变量的索引编号。对于格式设置规则中的每个
    {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}
    链接的变量值定义数字数据类型。
  • {2}
    链接的变量值定义小数位数。

数据类型

示例数据: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)
Numeric (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 ► -1,234.2
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
常量格式:
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]
  • 3.17:25:30.5000000
  • 4:30:00 AM
g
通用短格式:
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]
  • (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
扩展通用格式:
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]
  • (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}
LIKE
运算符参数化:
SELECT * FROM AlarmsDatalogger WHERE Name LIKE '{0}'
使用占位符将查询的一部分参数化:
SELECT * FROM Table1 {0}
具有索引
0
的占位符链接到项目字符串变量并将一列参数化;具有索引
1
的占位符链接到一个数值变量,该变量表示比较运算符
>
的值:
SELECT * FROM {0:sql_identifier} WHERE Column1 > {1:sql_literal}
将表名、列和
LIKE
运算符参数化:
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}
    )进行设置。

输出

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

示例

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