字符串格式器

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

属性

属性
说明
格式
变量引用格式设置规则：
  • 索引。用于标识输入变量的索引编号。对于格式设置规则中的每个 {index} 占位符，将显示一个指示源的新字段。
  • 对准。一个整数，表示根据规则格式化的源值的字符数。
  • 格式。要应用于输入变量的格式。
    格式占位符接受
    String.Format
     方法的 .NET Framework 表示法所需的值子集。占位符必须使用语法
    {index,alignment:format}
    。
    小贴士:
    要设置路径格式（例如
    ns=5;%PROJECTDIR%/Logo.svg
    ），可以使用：
    • {index,alignment:
      filepath
      }
      。将字符串设置为文件路径格式。
      示例：
      C:\Users\
      UserName
      \AppData\Local\Rockwell Automation\FactoryTalk Optix\Emulator\Projects\
      ProjectName
      \ProjectFiles\Logo.svg
    • {index,alignment:
      uri
      }
      。将字符串设置为 URI 格式。
      示例：
      file:///C:/Users/
      UserName
      /AppData/Local/Rockwell Automation/FactoryTalk Optix/Emulator/Projects/
      ProjectName
      /ProjectFiles/Logo.svg
模式
动态链接的方向：
  • 从源节点读取到父节点。
  • 从父节点写入源节点。
  • 从源节点读取到父节点，从父节点写入源节点。

源

一个或多个变量，由具有以下 {index} 格式的索引编号的占位符进行标识。索引编号是递进的，它必须是大于零 {0} 的整数。
小贴士: 占位符可以按任意顺序显示在格式设置规则中。例如，“{3}、{0} 和 {2} 的最小值为 {1}”语法有效。

数据类型

示例数据：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 文本值（
数字
、
字符串
、
日期
、
时间
等）。
-

反向格式设置

反向格式设置功能允许您在运行时修改带格式的值，将该值替换为应用程序在运行时以相同格式显示的新值。
必须进行以下设置，反向格式设置功能置才能正常运行：
  • 转换器的动态链接
    模式
    必须为
    读/写
    。
  • 格式
    字段只能有一个占位符或源。占位符可以具有后缀和/或前缀，并用格式字符串（如 {0:n}）进行设置。

输出

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

示例

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}'
提供反馈
对本文档有问题或反馈吗？ 请在这里提交您的反馈 。