跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL T_ADD — 时间相加

SCL T_ADD — 时间相加

两个 Time 相加。

日期时间 S7-1200/1500 TIA V19 别名:时间相加 / T_ADD

在 TIA 里试一下

通过 TiaLink 把本页示例(FB_TAdd_Demo)作为“外部源”导入你当前打开的 TIA Portal 项目:预检、生成块、编译,并清理外部源。导入后不会自动保存;FB 导入后需要在 OB 里调用。

TiaLink 设置

默认 http://localhost:8080。也可以在本页地址后加 ?tialink= 临时指定。

TiaLink 启动时若设置了 --api-token,这里要填相同的值;只保存在本机浏览器 localStorage,不会上传。

一句话

答案:#Result := T_ADD(IN1 := #A, IN2 := #B) 把两个时间值相加;TIME+Time 返回 Time,常用于累计运行时间。

T_ADD 把两个时间值相加:#Result := T_ADD(IN1 := #A, IN2 := #B);。TIME + TIME 返回 TIME;常用于累计运行时间、超时叠加。

参数

参数方向类型存储区说明
IN1输入TIME / LTIME / TOD / DTLI, Q, M, D, L, P第一个时间值。
IN2输入TIME / LTIMEI, Q, M, D, L, P要加上的时间长度。
Return返回值与 IN1 兼容的时间类型—相加结果;Time+Time 返回 Time,DTL+Time 返回 DTL。

参数表以 TIA Portal V19 帮助为事实核对;S7-1200/1500 有差异时在类型列并列显示。存储区是 TIA 允许的范围,实际可用范围还受块接口和优化属性影响。

最小示例

下面是一个完整块,页面展示的源码就是 TiaLink 导入的同一份源码。页面的场景已在 PLC 云仿真里跑过,输出见“云仿真验证”。

FB_TAdd_Demo FB

最小示例 · 18 行 · 源文件 blocks/FB_TAdd_Demo.scl

查看 FB_TAdd_Demo 的块接口
区块名称类型说明
输入ATime
输入BTime
输出ResultTime
blocks/FB_TAdd_Demo.scl
1FUNCTION_BLOCK "FB_TAdd_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      A : Time := T#1S;         // 第一个时间
6      B : Time := T#500MS;      // 要加的时间
7   END_VAR
8 
9   VAR_OUTPUT
10      Result : Time;            // 相加结果
11   END_VAR
12 
13BEGIN
14   REGION 时间相加
15      #Result := T_ADD(IN1 := #A, IN2 := #B);
16   END_REGION
17END_FUNCTION_BLOCK
18 

块接口表由源码自动生成;# 前缀表示块内局部变量,实际工程里也可以是全局标签或 DB 变量。

SCL 写法

SCL
1#Result := T_ADD(IN1 := #A, IN2 := #B);

也可以直接加时间常量:

SCL
1#Timeout := T_ADD(IN1 := #BaseTime, IN2 := T#5S);

怎么工作

输入 结果
T#1S + T#500MS T#1.5S
T#0S + T#0S T#0S
T#2S + T#-1S T#1S
DTL + TIME DTL(时间点加时长)
  • TIME/LTIME 是时间长度;DTL 是日期时间点。
  • 结果类型跟随输入组合;Time + Time 不会变成 DTL。
  • 超出类型范围会报错/无效;累计时间要预估上限。
  • 时间单位由字面量决定:T#500MS 是 500 毫秒。

常用场景

1. 累计运行时间

把每次扫描的 CycleTime 累加到 TotalTime;配合 TONR 或 DInt 毫秒计数。

2. 超时叠加

基础超时加上工艺延时:T_ADD(BaseTime, ExtraTime);比手写毫秒数清楚。

3. 时间点加时长

DTL + TIME 得到新的时间点;用于排程/到期时间。

常见坑

  • 单位混淆:T#5 不是 5 秒;写 T#5S 或 T#5000MS。
  • 溢出:Time 是 32 位毫秒,约 49 天;长时间累计用 LTIME 或 DInt 秒/毫秒。
  • 把 T_ADD 当日期加:DTL + Time 可以;Date + Time 不是同一种运算,日期加天数要按日期规则。
  • 负时间:Time 可以表示负时长,但下游定时器 PT 通常要求正数。
  • 类型不匹配:Time 和 LTIME 混用要确认结果类型;必要时显式转换。
  • 忽略扫描周期:累计时间应使用实际 CycleTime,不要假设固定 10ms。

和 LAD 的区别

LAD 的 T_ADD 是带 IN1/IN2 的盒;SCL 里直接写函数调用,可以放在表达式里。语义一样,SCL 更容易把时间累计写成一行。梯形图版本见 Learn-LAD 的 T_ADD 页。

云仿真验证

PLC 云仿真:PASS(3 次扫描)。场景:1 秒 + 500 毫秒;零和负时间。结果来自 PLC 云仿真 的 scl_run_scenario。

查看云仿真回归输出
云仿真回归输出
PASS  1 秒 + 500 毫秒 (1 step(s), 1 scan(s))
PASS  零和负时间 (2 step(s), 2 scan(s))
RESULT: ALL PASS (3 scan(s))

云仿真验证语法、结构和逐扫描行为,不等同于 TIA 编译;TIA 状态见下方“验证状态”。

验证状态

项目结果日期证据
构建期语法/结构校验PASS2026-11-02parse + validate
PLC 云仿真PASS(3 scans)2026-11-02scl_run_scenario / scl_validate
TIA 导入编译PASS(0 error / 0 warning)2026-11-02TiaLink + TIA Portal

“待实测”表示还没有在 TIA Portal 里导入编译,不代表代码有问题;上机前请先在测试项目编译。云仿真在 tia.hubwiz.com/sim 执行,不替代 TIA 编译。

来源与说明

参数、行为和数据类型的核对来源:TIA Portal V19 帮助的 Instructions/Instructions/Extended_instructions/Date_and_time/T_ADD__Add_times.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

参数类型和 TIME 相加语义以 TIA Portal V19 帮助为事实核对;中文讲解、SCL 示例和验证场景由 Learn-SCL 编写。

Siemens 文档与截图的版权归 Siemens;本站只引用事实参数,不复制官方描述段落和图片。官方参考:Siemens TIA Portal。

常见问题

T_ADD 可以加两个 Time 吗?

可以。`T_ADD(IN1 := T#1S, IN2 := T#500MS)` 返回 `T#1.5S`;也可以用于 DTL + Time。

T_ADD 和普通加法有什么区别?

T_ADD 按时间类型处理单位/溢出;普通 `+` 对 Time 也可用,但 T_ADD 更明确,跨类型时规则更清楚。

结果溢出会怎样?

超出 Time/LTIME 范围会报错或得到无效值;累计时间要预估上限,必要时用 LTIME/DInt 毫秒。

← 返回 SCL 指令手册