在 TIA 里试一下
通过 TiaLink 把本页示例（FB_TDiff_Demo）作为“外部源”导入你当前打开的 TIA Portal 项目：预检、生成块、编译，并清理外部源。导入后不会自动保存；FB 导入后需要在 OB 里调用。
一句话
答案：#Result := T_DIFF(IN1 := #EndTime, IN2 := #StartTime) 返回两个时间标签的差；DTL-DTL 超过 24 天时用 T_DIFF_LTIME 避免 TIME 溢出。
T_DIFF 返回两个时间标签的差：#Result := T_DIFF(IN1 := #EndTime, IN2 := #StartTime);。结果是时长；IN1 早于 IN2 时为负。
参数
| 参数 | 方向 | 类型 | 存储区 | 说明 |
|---|
IN1 | 输入 | TIME / LTIME / TOD / DTL | I, Q, M, D, L, P | 结束/较晚的时间标签。 |
IN2 | 输入 | TIME / LTIME / TOD / DTL | I, Q, M, D, L, P | 开始/较早的时间标签。 |
Return | 返回值 | TIME / LTIME | — | 两个时间标签的差，结果是时长；DTL-DTL 超过 24 天时 TIME 变体可能溢出。 |
参数表以 TIA Portal V19 帮助为事实核对；S7-1200/1500 有差异时在类型列并列显示。存储区是 TIA 允许的范围，实际可用范围还受块接口和优化属性影响。
最小示例
下面是一个完整块，页面展示的源码就是 TiaLink 导入的同一份源码。页面的场景已在 PLC 云仿真里跑过，输出见“云仿真验证”。
FB_TDiff_Demo FB
最小示例 · 18 行 · 源文件 blocks/FB_TDiff_Demo.scl
查看 FB_TDiff_Demo 的块接口
| 区块 | 名称 | 类型 | 说明 |
|---|
| 输入 | EndTime | Time | |
| 输入 | StartTime | Time | |
| 输出 | Diff | Time | |
blocks/FB_TDiff_Demo.scl
1FUNCTION_BLOCK "FB_TDiff_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4 VAR_INPUT
5 EndTime : Time := T#5S;
6 StartTime : Time := T#1.5S;
7 END_VAR
8
9 VAR_OUTPUT
10 Diff : Time;
11 END_VAR
12
13BEGIN
14 REGION 求时间差
15 #Diff := T_DIFF(IN1 := #EndTime, IN2 := #StartTime);
16 END_REGION
17END_FUNCTION_BLOCK
18
块接口表由源码自动生成；# 前缀表示块内局部变量，实际工程里也可以是全局标签或 DB 变量。
SCL 写法
SCL
1#Duration := T_DIFF(IN1 := #EndTime, IN2 := #StartTime);
时间点（DTL）相减：
SCL
1#Duration := T_DIFF(IN1 := #EndDTL, IN2 := #StartDTL);
怎么工作
| 输入 |
结果 |
T#5S 和 T#1.5S |
T#3.5S |
T#1S 和 T#2S |
T#-1S |
DTL 和 DTL |
TIME 差值 |
TOD 和 TOD |
TIME 差值 |
- 结果是时长（Time/LTIME），不是时间点。
IN1 是结束/较晚时间，IN2 是开始/较早时间；反了会得到负值。- DTL-DTL 的 TIME 变体有 24 天限制；超过时用
T_DIFF_LTIME。
- 两个输入的类型/格式要一致；TOD 和 DTL 不能混。
常用场景
1. 计算设备运行时长
记录启动 StartDTL 和停止 EndDTL，用 T_DIFF 得到本次运行时长；再累加。
2. 计算节拍/周期
两个时间点相减得到实际节拍；与设定节拍比较，做超时/性能统计。
3. 计算剩余时间
到期时间减当前时间得到剩余时长；为负表示已超时。
常见坑
- 顺序反了：
IN1 是结束、IN2 是开始；反了会得到负值。
- 超过 24 天：DTL-DTL 的 TIME 差可能溢出；用
T_DIFF_LTIME 或分段累计。
- 类型不一致：TOD 和 DTL 不能混；两个输入要用同一种时间格式。
- 把结果当时间点：T_DIFF 返回时长，不能直接当日期时间显示。
- 忽略时区/夏令时：本地时间差可能受夏令时影响；需要绝对时间用 UTC/系统时间。
- 扫描周期：运行时长用实际时间戳差，不要用扫描次数乘固定周期。
和 LAD 的区别
LAD 的 T_DIFF 是带 IN1/IN2 的盒；SCL 里直接写函数调用，可以放在表达式里。语义一样，SCL 更容易把时间差和统计逻辑连写。梯形图版本见 Learn-LAD 的 T_DIFF 页。
云仿真验证
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（有警告） | 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 编写。
T_DIFF 的专用帮助页在抓取语料中损坏；时间差语义以 TIA V19 时间相减页、算术表达式表和实际编译为准。中文讲解、SCL 示例和验证场景由 Learn-SCL 编写。
Siemens 文档与截图的版权归 Siemens；本站只引用事实参数，不复制官方描述段落和图片。官方参考：Siemens TIA Portal。
常见问题
T_DIFF 和 T_SUB 有什么区别？
T_DIFF 专门求两个时间标签的差（结果时长）；T_SUB 是通用减法，支持更多类型组合。
DTL 时间差超过 24 天怎么办？
TIME 变体的 DTL-DTL 差有 24 天限制；用 `T_DIFF_LTIME` 或先转成更宽的时间类型。
T_DIFF 的结果是正数吗？
IN1 早于 IN2 时结果为负；业务上通常用较晚时间减较早时间，或先判断顺序。
