字符串格式器

根据可自定义的规则修改一个或多个值的格式。
字符串格式器可用于：
  • 在某个值前后添加字符（如果源变量的值为数值）。
  • 将 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}
    ）进行设置。

输出

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

示例

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