输出文本中带有格式定义的占位符

可视化输出的字符串可以包括变量的占位符‎%‎ 。运行时，占位符将被定义格式的变量实际值所取代。格式定义和变量的数据类型必须一致。一个字符串最多只能包含一个占位符。

用于输出的字符串列于“文本” 属性中。分配的变量在“文本变量” 属性中列出。

另见

输出整数

`‎%d‎` `‎%i‎`	将变量（整数数据类型）输出为十进制数	代码 `‎iCounter : INT := 12;‎` Property“Text” ： `‎Value: %i‎` 属性“文本变量” ： `‎PLC_PRG.iCounter‎` 输出： `‎Value: 12‎`
`‎%b‎`	将变量（整数数据类型）输出为二进制数	代码 `‎byCode : BYTE := 255;‎` Property“Text” ： `‎Coding: %b‎` 属性“文本变量” ： `‎PLC_PRG.byCode‎` 输出： `‎Coding: 11111111‎`
`‎%o‎`	将变量（整数数据类型）输出为无符号八进制数，前面不加 0	代码 `‎byCode : BYTE := 8#377;‎` Property“Text” ： `‎Coding: %o‎` 属性“文本变量” ： `‎PLC_PRG.byCode‎` 输出： `‎Coding: 377‎`
`‎%x‎`	将变量（整数数据类型，最多 32 位）输出为无符号十六进制数，前面不带 "0x"。	代码 `‎dwCode : INT := 16#FFFFFFFF;‎` Property“Text” ： `‎Coding: %x‎` 属性“文本变量” ： `‎PLC_PRG.dwCode‎` 输出： `‎Coding: ffffffff‎`
`‎%llX‎` `‎%012llX‎`	输出 64 位变量 (`‎LWORD‎`,`‎LINT‎`,`‎ULINT‎`) 的十六进制数。注：`‎llx‎` 表示 "长长的十六进制"。	代码 `‎lwCode : LWORD := 16#4FFF_3FFF_2FFF_1FFF;‎` Property“Text” ： `‎Coding: %llx‎` 属性“文本变量” ： `‎PLC_PRG.lwCode‎` 输出： `‎Coding: 4fff3fff2fff1fff‎`
`‎%u‎`	将变量（整数数据类型）输出为无符号十进制数	代码 `‎uiNumber : UINT := 1234;‎` Property“Text” ： `‎Number: %u‎` 属性“文本变量” ： `‎PLC_PRG.uiNumber‎` 输出： `‎Number: 1234‎`

输出浮点数

浮点数的数据类型为‎REAL‎ 或‎LREAL‎ 。

`‎%f‎`	小数形式，带小数点，格式为 1.6	代码 `‎rWeight : REAL := 1.123456789;‎` Property“Text” ： `‎Weight: %f‎` 属性“文本变量” ： `‎PLC_PRG.rWeight‎` 输出： `‎Weight: 1.123456‎`
`‎%<alignment><minimum width>.<accuracy>f‎`	以用户定义的格式表示为十进制数 `‎<alignment>‎`：`‎-‎` 或`‎+‎` ，可选 `‎-‎`:左对齐 `‎+‎`:右对齐 `‎<minimum width>‎`:小数点左边的位数 `‎<accuracy>‎`:小数点右边的位数	代码 `‎rWeight : REAL := 12.1‎` Property“Text” ： `‎Weight: %2.3f‎` 属性“文本变量” ： `‎PLC_PRG.rWeight‎` 输出： `‎Weight: 12.100‎`
`‎%e‎`	以指数形式输出浮点数（`‎REAL‎` 或`‎LREAL‎` ）的基数 `‎10‎`	代码 `‎rValue : REAL := 1.234567%e-003;‎` Property“Text” ： `‎Value: %E‎` 属性“文本变量” ： `‎PLC_PRG.rValue‎` 输出： `‎Value: 1.23E-6‎`
`‎%E‎`	以指数形式输出浮点数（`‎REAL‎` 或`‎LREAL‎` ）的基数 `‎10‎`	代码 `‎rValue : REAL := 1.234567%e-003;‎` Property“Text” ： `‎Value: %e‎` 属性“文本变量” ： `‎PLC_PRG.rValue‎` 输出： `‎Value: 1.23e-6‎`

输出文本

‎%c‎

输出 ASCII 字符集中的单字符

代码 ‎bChar := 16#41;‎

Property“Text” ： ‎Key: %c‎

属性“文本变量” ： ‎PLC_PRG.bChar‎

输出： ‎Key: A‎

‎%s‎

字符串的输出

代码 ‎strName := 'Paul Smith';‎

Property“Text” ： ‎Name: %s‎

属性“文本变量” ： ‎PLC_PRG.strName‎

输出： ‎Name: Paul Smith‎

百分比符号的输出

‎%%‎

在字符串中输出百分号

Property“Text” ： ‎Valid until 90%%‎

输出： ‎Valid until 90%‎

代码 ‎iPercentage : INT := 80;‎

Property“Text” ： ‎Valid until %d%%.‎

属性“文本变量” ： ‎PLC_PRG.iPercentage := 80;‎

输出： ‎Valid until 80%‎

输出日期和时间

如果元素“Text” 属性中的输出文本包含占位符"%t"，则会输出日期和/或时间。如果变量未在“文本变量” 属性中指定，则输出系统时间；否则输出该变量的值。

默认情况下，日和月的名称以英文显示。如果使用本地化文本，则必须补充文本列表‎System‎ 。当使用占位符 %t 时，该文本列表会在“POUs” 视图中自动创建。这里必须使用英文术语作为 ID。缩写名和全名都可以进行本地化。

时间数据类型包括‎LTIME‎,‎TIME‎,‎TIME_OF_DAY‎,‎TOD‎,‎DATE‎,‎DATE_AND_TIME‎ 和‎DT‎ 。

兼容性通知

在 V3.5 SP17 及更高版本中，为了获得常规显示，通常使用三位数来输出秒分数（ms/µs/ns）。示例：在‎%t[dd-HH:mm:ss:ms]‎ 中，‎ms‎ 用三位数指定毫秒。为此，两位数的 ms 号码前要加上一个 0。如果需要两位数输出（如 V3.5 SP17 之前），则必须在应用程序的编译器属性中设置一个特殊的编译器定义：‎VISU_MILLISEC_NOLEADING_ZERO‎ 。

日期和时间格式
`‎%t[yyyy]‎`	有世纪的年份	代码 `‎dateBy : DATE := DATE#2020-1-1;‎` Property“Text” ： `‎By the year %t[yyyy]‎` 属性“文本变量” ： `‎PLC_PRG.dateBy‎` 输出： `‎By the year 2020‎`
`‎%t[yy]‎`	不含世纪的年份（00-99）	代码 `‎dateSince : DATE := DATE#2000-1-1;‎` Property“Text” ： `‎Since: %t[yy]‎` 属性“文本变量” ： `‎PLC_PRG.dateSince‎` 输出： `‎Since: 00‎`
`‎%t[y]‎`	无世纪年份（0-99）	代码 `‎dateSince : DATE := DATE#2000-1-1;‎` Property“Text” ： `‎Since: %t[y]‎` 属性“文本变量” ： `‎PLC_PRG.dateSince‎` 输出： `‎Since: 0‎`

`‎%t[MMMM]‎`	月作为全名	代码 `‎dateMonth : DATE := DATE#2016-1-1;‎` Property“Text” ： `‎Month: %t[MMMM]‎` 属性“文本变量” ： `‎PLC_PRG.dateMonth‎` 输出： `‎Month: January‎`
`‎%t[MMM]‎`	月作为缩写名称	代码 `‎dateMonth : DATE := DATE#2016-1-1;‎` 属性“文本”:： `‎Month: %t[MMM]‎` 属性“文本变量” ： `‎PLC_PRG.dateMonth‎` 输出： `‎Month: Jan‎`
`‎%t[MM]‎`	以数字表示的月份（01-12）	代码 `‎dateMonth : DATE := DATE#2016-1-1;‎` 属性“文本”:： `‎Month: %t[MM]‎` 属性“文本变量” ： `‎PLC_PRG.dateMonth‎` 输出： `‎Month: 01‎`
`‎%t[M]‎`	以数字表示的月份（1-12）	代码 `‎dateMonth : DATE := DATE#2016-1-1;‎` 属性“文本”:： `‎Month: %t[M]‎` 属性“文本变量” ： `‎PLC_PRG.dateMonth‎` 输出： `‎Month: 1‎`

`‎%t[ddddd]‎`	以数字表示的星期（1=周一 - 7=周日）	代码 `‎iDay : INT := 7;‎` 属性“文本”:： `‎Day: %t[ddddd]‎` 属性“文本变量” ： `‎PLC_PRG.iDay‎` 输出： `‎Day: 7‎`
`‎%t[dddd]‎`	星期作为全名	代码 `‎iDay : INT := 7;‎` 属性“文本”:： `‎Day: %t[dddd]‎` 属性“文本变量” ： `‎PLC_PRG.iDay‎` 输出： `‎Day: Sunday‎`
`‎%t[ddd]‎`	星期缩写	代码 `‎iDay : INT := 7;‎` 属性“文本”:： `‎Day: %t[ddd]‎` 属性“文本变量” ： `‎PLC_PRG.iDay‎` 输出： `‎Day: Sun‎`
`‎%t[dd]‎`	以数字表示的月日 (01-31)	代码 `‎iDay : INT := 1;‎` 属性“文本”:： `‎Day: %t[dd]‎` 属性“文本变量” ： `‎PLC_PRG.iDay‎` 输出： `‎Day: 01‎`
`‎%t[d]‎`	以数字表示的月日 (1-31)	代码 `‎iDay : INT := 1;‎` 属性“文本”:： `‎Day: %t[d]‎` 属性“文本变量” ： `‎PLC_PRG.iDay‎` 输出： `‎Day: 1‎`
`‎%t[jjj]‎`	以数字表示的年月日（001-366）	代码 `‎dateOfNoReturn : DATE := DATE#2016-09-01;‎` 属性“文本”:： `‎Day of no return: %t[jjj]‎` 属性“文本变量” ： `‎PLC_PRG.dateOfNoReturn‎` 输出： `‎Day of no return: 245‎`

`‎%t[HH]‎`	小时，24 小时制（00-23）	代码 `‎todEnd : TOD := TIME_OF_DAY#17:0:0;‎` Property“Text” ： `‎Ends at: %t[HH]:00‎` 属性“文本变量” ： `‎PLC_PRG.todEnd‎` 输出： `‎Ends at 17:00‎`
`‎%t[hh]‎`	小时（12 小时制）（01-12	代码 `‎todEnd : TOD := TIME_OF_DAY#17:0:0;‎` Property“Text” ： `‎Ends at: %t[hh] o'clock‎` 属性“文本变量” ： `‎PLC_PRG.todEnd‎` 输出： `‎Ends at: 05 o'clock‎`

`‎%t[mm]‎`	带前导零的分钟数（00-59）	代码 `‎tPeriod : TIME := T#5M;‎` Property“Text” ： `‎Period: %t[mm]m‎` 属性“文本变量” ： `‎PLC_PRG.tPeriod‎` 输出： `‎Period: 05m‎`
`‎%t[m]‎`	不含前导零的分钟数（0-59）	代码 `‎tPeriod : TIME := T#5m;‎` Property“Text” ： `‎Period: %t[m 'm']‎` 属性“文本变量” ： `‎PLC_PRG.tPeriod‎` 输出： `‎Period: 5 m‎`
`‎%t[ss]‎`	带前导零的秒数（00-59）	代码 `‎tPeriod : TIME := T#5m3s;‎` Property“Text” ： `‎Period: %t[mm'm'ss's']‎` 属性“文本变量” ： `‎PLC_PRG.tPeriod‎` 输出： `‎Period: 05m03s‎`
`‎%t[s]‎`	不含前导零的秒数（0-59）	代码 `‎tPeriod : TIME := T#5m3s;‎` Property“Text” ： `‎Period: %t[m'm' s's']‎` 属性“文本变量” ： `‎PLC_PRG.tPeriod‎` 输出： `‎Period: 5m 3s‎`
`‎%t[ms]‎`	毫秒，不含前导零（0-999）	代码 `‎tPeriod : TIME := T#500ms;‎` Property“Text” ： `‎Period: %t[ms 'ms']‎` 属性“文本变量” ： `‎PLC_PRG.tPeriod‎` 输出： `‎Period: 500 ms‎`
`‎%t[us]‎`	仅适用于`‎LTIME‎` 变量：微秒定义（0-999）	代码 `‎ltPeriod :LTIME := LTIME#1000D23H44M12S34MS2US44NS;‎` Property“Text” ： `‎'Period': %t[dd.HH.m.s.ms.us.ns]‎` 属性“文本变量” ： `‎PLC_PRG.ltPeriod‎` 输出： `‎Period: 1000.23.44.12.34.2.44‎` 提示允许在定义的最大时间单位内溢出。
`‎%t[ns]‎`	仅适用于`‎LTIME‎` 变量：纳秒定义（0-999）

`‎%t[t]‎`	如果值为时间 < 12h，则输出 A；否则输出 P。	代码 `‎tClosed : TOD := TOD#17:17:17.17;‎` Property“Text” ： `‎Closed at %t[hh:mm t]‎` 属性“文本变量” ： `‎PLC_PRG.tClosed‎` 输出： `‎Closed at 05:17 P‎`
`‎%t[tt]‎`	如果数值为时间 < 12h ，则输出 AM；否则输出 PM。	代码 `‎tClosed : TOD := TOD#17:17:17.17;‎` Property“Text” ： `‎Closed at %t[hh:mm tt]‎` 属性“文本变量” ： `‎PLC_PRG.tClosed‎` 输出： `‎Closed at 05:17 PM‎`

`‎%t[' ']‎`	如果要输出与格式定义相对应的字符串，则必须用单引号表示。
`‎TIME‎` 和`‎LTIME‎` 值可指定为整数或小数位：
`‎%t[<f><n>]‎`	在定义时间单位（<f>）的字母后面有一个数字（<n>），用于定义时间值的小数位数。因此，小时、分钟和秒（对于 TIME 值）以及微秒和纳秒（对于 LTIME 值）都可以指定或显示为带小数位的值。请注意：即使输入或显示不需要十进制数，至少也要指定数字 "0"，以允许小数输入。	格式化示例 `‎%t[hh4]‎` 或`‎%t[HH4]‎` ：时间可以用小数点后四位的小时定义来指定/显示。 `‎%t[mm2]‎` 或`‎%t[m2]‎` ：时间可以用小数点后四位的分钟定义来指定/显示。对于`‎t#1h20m15s‎` 的值，输出结果如下：`‎80.25‎` 。 `‎ %t[ss0]‎`:时间可以用第二个定义来指定/显示，不带小数位。

格式定义可以用系列表示。
`‎%t[HH:mm:ss:ms]‎`	时间输出	代码 `‎dwTime : DWORD := 4294967295;‎` Property“Text” ： `‎Time: %t[HH:mm:ss:ms]‎` 属性“文本变量” ： `‎PLC_PRG.dwTime‎` 输出： `‎Time: 23:59:59:999‎`
%t[yyyy-MM-dd dddd]	输出日期和星期	代码 `‎dateSet : DATE := DATE#2016-02-12;‎` Property“Text” ： `‎Date: %t[yyyy-MM-dd dddd]‎` 属性“文本变量” ： `‎PLC_PRG.dateSet‎` 输出： `‎Date: 2016-02-12 Friday‎`

另见

‎⮫ 时间数据类型