在 TIA 里试一下
通过 TiaLink 把本页示例（FB_TSub_Demo）作为“外部源”导入你当前打开的 TIA Portal 项目：预检、生成块、编译，并清理外部源。导入后不会自动保存；FB 导入后需要在 OB 里调用。
一句话
答案：#Result := T_SUB(IN1 := #A, IN2 := #B) 把两个时间值相减；Time-Time 返回 Time，可用于计算剩余时间。
T_SUB 把两个时间值相减：#Result := T_SUB(IN1 := #A, IN2 := #B);。TIME - TIME 返回 TIME；结果可以为负，但下游定时器通常要求正数。
参数
| 参数 | 方向 | 类型 | 存储区 | 说明 |
|---|
IN1 | 输入 | TIME / LTIME / TOD / DTL | I, Q, M, D, L, P | 被减的时间值。 |
IN2 | 输入 | TIME / LTIME / TOD / DTL | I, Q, M, D, L, P | 要减去的时间值。 |
Return | 返回值 | 与输入组合兼容的时间类型 | — | 相减结果；Time-Time 返回 Time，DTL-Time 返回 DTL。 |
参数表以 TIA Portal V19 帮助为事实核对；S7-1200/1500 有差异时在类型列并列显示。存储区是 TIA 允许的范围，实际可用范围还受块接口和优化属性影响。
最小示例
下面是一个完整块，页面展示的源码就是 TiaLink 导入的同一份源码。页面的场景已在 PLC 云仿真里跑过，输出见“云仿真验证”。
FB_TSub_Demo FB
最小示例 · 18 行 · 源文件 blocks/FB_TSub_Demo.scl
查看 FB_TSub_Demo 的块接口
| 区块 | 名称 | 类型 | 说明 |
|---|
| 输入 | A | Time | |
| 输入 | B | Time | |
| 输出 | Result | Time | |
blocks/FB_TSub_Demo.scl
1FUNCTION_BLOCK "FB_TSub_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4 VAR_INPUT
5 A : Time := T#5S;
6 B : Time := T#1.5S;
7 END_VAR
8
9 VAR_OUTPUT
10 Result : Time;
11 END_VAR
12
13BEGIN
14 REGION 时间相减
15 #Result := T_SUB(IN1 := #A, IN2 := #B);
16 END_REGION
17END_FUNCTION_BLOCK
18
块接口表由源码自动生成；# 前缀表示块内局部变量，实际工程里也可以是全局标签或 DB 变量。
SCL 写法
SCL
1#Remaining := T_SUB(IN1 := #SetTime, IN2 := #Elapsed);
时间点减时长：
SCL
1#Reminder := T_SUB(IN1 := #DueTime, IN2 := T#5M);
怎么工作
| 输入 |
结果 |
T#5S - T#1.5S |
T#3.5S |
T#1S - T#2S |
T#-1S |
DTL - TIME |
DTL |
TOD - TOD |
TIME |
- 结果是时间长度（Time）或时间点（DTL），取决于输入组合。
- Time 可以表示负时长；定时器 PT、延时等通常要求正数，使用前检查。
- 超出类型范围会报错/无效；大范围用 LTIME。
- 单位由字面量决定：
T#500MS 是 500 毫秒。
常用场景
1. 计算剩余时间
设定时间减已用时间得到剩余时间；剩余为负说明已超时。
2. 计算提前量
到期时间减 5 分钟得到提醒时间；DTL - TIME 返回 DTL。
3. 时间差统计
两个时间点相减得到时长；更专门的 T_DIFF 也可以，但 T_SUB 支持更多类型组合。
常见坑
- 负结果直接给定时器：PT 通常要求正数；先判断/限幅。
- 单位混淆：
T#5 不是 5 秒；写 T#5S。
- 溢出：Time 约 49 天上限；长时间用 LTIME。
- 日期/时间点混用：DTL - TIME 是时间点；TIME - TIME 是时长，不要混。
- 忽略扫描周期：用实际 CycleTime 累计，不要假设固定周期。
- 把 T_SUB 当 T_DIFF：T_DIFF 专门求时间标签差；通用减法用 T_SUB。
和 LAD 的区别
LAD 的 T_SUB 是带 IN1/IN2 的盒；SCL 里直接写函数调用，可以放在表达式里。语义一样，SCL 更容易把剩余时间写成一行。梯形图版本见 Learn-LAD 的 T_SUB 页。
云仿真验证
PLC 云仿真：PASS（2 次扫描）。场景：5 秒减 1.5 秒；结果为负。结果来自 PLC 云仿真 的 scl_run_scenario。
查看云仿真回归输出
云仿真回归输出
PASS 5 秒减 1.5 秒 (1 step(s), 1 scan(s))
PASS 结果为负 (1 step(s), 1 scan(s))
RESULT: ALL PASS (2 scan(s))
云仿真验证语法、结构和逐扫描行为，不等同于 TIA 编译；TIA 状态见下方“验证状态”。
验证状态
| 项目 | 结果 | 日期 | 证据 |
|---|
| 构建期语法/结构校验 | PASS | 2026-11-02 | parse + validate |
| PLC 云仿真 | PASS（2 scans） | 2026-11-02 | scl_run_scenario / scl_validate |
| TIA 导入编译 | PASS（0 error / 0 warning） | 2026-11-02 | TiaLink + TIA Portal |
“待实测”表示还没有在 TIA Portal 里导入编译，不代表代码有问题；上机前请先在测试项目编译。云仿真在 tia.hubwiz.com/sim 执行，不替代 TIA 编译。
来源与说明
参数、行为和数据类型的核对来源：TIA Portal V19 帮助的 Instructions/Instructions/Extended_instructions/Date_and_time/T_SUB__Subtract_times.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。
参数类型和时间相减语义以 TIA Portal V19 帮助为事实核对；中文讲解、SCL 示例和验证场景由 Learn-SCL 编写。
Siemens 文档与截图的版权归 Siemens；本站只引用事实参数，不复制官方描述段落和图片。官方参考：Siemens TIA Portal。
常见问题
T_SUB 的结果可以是负数吗？
Time 可以表示负时长；但定时器 PT、延时等通常要求正数，使用前检查。
T_SUB 和 T_DIFF 有什么区别？
T_SUB 是通用时间减法，支持多种时间类型组合；T_DIFF 专门求两个时间标签的差，结果也是时长。
时间点减时长怎么算？
DTL 减去 TIME 返回 DTL；例如到期时间减 5 分钟得到提醒时间。
