T_DIFF： 时间值相减(S7-1200, S7-1500) 说明 使用该指令将 IN1 输入参数中的时间值减去 IN2输入参数中的时间值。结果将发送到输出参 数 OUT 中。 • 如果 IN2 输入参数中的时间值大于 IN1 输入参数中的时间值，则OUT 输出参数中将输出 一个负数结果。 • 如果减法运算的结果超出 TIME 值范围，则使能输出 ENO的值为“0”。根据所用的数据类 型，获得的结果值截断或为“0”(0:00)。 – 如果选择 DTL数据类型的被减数和减数，则计算结果的数据类型为 TIME。不能大于 24 天，否则使能输出 ENO 的值为“0”，且结果为“0”。 –如果选择数据类型为 LDT 的被减数和减数，则可避免该限制条件。说明 该指令用于合并日期值和时间值，并生成一个合并日期时间值。 •日期在输入参数 IN1 中输入。对于数据类型 DATE，请使用介于 1990-01-01 和 2089-12-31之间的值（系统不会对此进行检查）。 • 此时间在 IN2 输入值（TOD/LTOD 数据类型）中输入。 •合并后的日期和时间值数据类型在 OUT 输出值中输出。 参数 下表列出了“T_COMBINE”指令的参数： 参数 声明 数据类型存储区 说明 S7-1200 S7-1500 IN1 Input DATE DATE I、Q、M、D、L、 P 或常量 日期的输入变量IN2 Input TOD TOD, LTOD I、Q、M、D、L、 P 或常量 时间的输入变量 OUT Return DTL DT,DTL, LDT I、Q、M、D、L、 P 日期和时间的返回值 有关有效数据类型的更多信息，请参见“有效数据类型概述(页 255)”。 说明 在 SCL 程序中使用 T_COMBINE将指令“T_COMBINE”从“指令”(Instructions) 任务卡拖放到 SCL 编程窗口中时，内部指令CONCAT_DATE_TOD 或 CONCAT_DATE_LTOD 显示在该窗口内。 示例 在以下示例中，将 TOD数据类型的时间与 DATE 数据类型的日期组合在一起。以 DT 数据类 型指定返回值。 在全局数据块中，创建 3个变量进行数据存储。
如下所示互连指令的参数并选择数据类型。使用第一个选项，指定时间的数据类型（“valueTOD”）。使用第二个选项，指定返回值的数据类型（“combTIME”）。日期（“valueDATE”将按照时间（“valueTOD”）的规范进行扩展，返回值通过输出参数 OUT（“combTIME”）显示。 有关上述示例的更多信息和程序代码，请参见“Sample Library forInstructions (页 713)”时间函数 (S7-1200, S7-1500) WR_SYS_T： 设置时间(S7-1200, S7-1500) 说明 使用该指令，可设置 CPU 时钟的日期和时间（模块时间）。在输入参数 IN 中输入日期和时间。输入值必须介于以下范围内： • 对于 DT：Zui小为 DT#1990-01-01-0:0:0，Zui大为DT#2089-12-31-23:59:59.999 • 对于 LDT：Zui小为LDT#1970-01-01-0:0:0.000000000，Zui大为LDT#2200-12-31-23:59:59.999999999 • 对于 DTL：Zui小为DTL#1970-01-01-00:00:00.0，Zui大为 DTL#2200-12-31-23:59:59.999999999 可以在RET_VAL 输出参数中查询在执行该指令期间是否发生了错误。 “WR_SYS_T”指令不能用于传递有关本地时区或夏令时信息。 说明CPU 时钟的模块时间 CPU 时钟将模块时间转换为世界协调时间 (UTC)。因此，模块时间总是存储在 CPU 时钟中，而不带因子“本地时区”或“夏令时”。之后，CPU 时钟将基于模块时间计算 CPU 时钟的 本地时间。 CPU 时钟的模块时间将用作CPU 发起的所有时间处理过程的模板。使用示例： • 基于模块时间计算 CPU 时钟的本地时间 • 在“在线与诊断”(Online &Diagnostics) 中，显示本地时间中的模块时间 • 块属性 • CPU 诊断缓冲区中的条目您可以确定 CPU时钟是否正确接收了新模块时间（“inputTIME”），如下所示： • 使用 S7-1500 CPU 的显示屏：在 CPU显示屏上导航到“设置 > 日期和时间 > 常 规”(Settings > Date & Time >General)。 • 使用 TIA Portal：使用“RD_SYS_T (页 2633)”指令读取 CPU时钟的模块时间。 • 使用 TIA Portal：导航到 CPU 的“在线与诊断”(Online & Diagnostics)条目，并打开“功 能 > 设置时间”(Functions > Set time of day) 选项卡。 为 CPU时钟的模块时间设置协调世界时间 (UTC)。在本示例中，在 TIA Portal 参数中将欧 洲中部时间设置为本地时间。在 TIAPortal 的“在线与诊断”(Online & Diagnostics) 条目 中为要设置的时间（“inputTIME”）相应地增加1 小时。使用夏令时，需额外增加一个小 时。计算出的本地时间以 12 小时制格式输出。有关上述示例的更多信息和程序代码，请参见“Sample Library for Instructions ” 参见转换程序状态的显示格式 (页 10442) RD_SYS_T： 读取时间 (S7-1200, S7-1500) 说明可以使用该指令读取 CPU 时钟的当前日期和当前时间（模块时间）。在此指令的 OUT输出参数中输出读取的日期。得出的值不包含有关本地时区或夏令时的信息。 说明 CPU 时钟的模块时间 CPU时钟将模块时间转换为世界协调时间 (UTC)。因此，模块时间总是存储在 CPU 时钟中，而不带因子“本地时区”或“夏令时”。之后，CPU 时钟将基于模块时间计算 CPU 时钟的 本地时间。 CPU 时钟的模块时间将用作CPU 发起的所有时间处理过程的模板。使用示例： • 基于模块时间计算 CPU 时钟的本地时间 • 在“在线与诊断”(Online &Diagnostics) 中，显示本地时间中的模块时间 • 块属性 • CPU 诊断缓冲区中的条目 可以在 RET_VAL输出中查询在执行该指令期间是否发生了错误。在以下示例中，读取 CPU 时钟的模块时间。使用的数据类型为 DATE AND TIME。在全局数据块中创建两个用于存储数据的变量。 互连该指令的参数，如下所示：选择 DATE AND TIME 数据类型。 将读取 CPU时钟的模块时间，并通过输出参数 OUT（“outputTIME”）显示。输出参数RET_VAL（“returnValue”）用于指示处理无错误。有关上述示例的更多信息和程序代码，请参见“Sample Libraryfor Instructions (页 713)” 参见 转换程序状态的显示格式 (页 10442)RD_LOC_T： 读取本地时间 (S7-1200, S7-1500) 说明 使用该指令从 CPU 时钟读取当前本地时间，并将此时间在OUT 输出中输出。在输出本地时 间时，会用到夏令时和标准时间的时区和开始时间（已在 CPU 时钟的组态中设置）的相关信息。在以下示例中，读取 CPU 时钟的本地时间。使用的数据类型为 DATE AND TIME。在全局数据块中创建两个用于存储数据的变量。 互连该指令的参数，如下所示：选择 DATE AND TIME 数据类型。 将读取 CPU时钟的本地时间，并通过输出参数 OUT（“outputLocTIME”）显示。输出参数RET_VAL（“returnValue”）指示处理无错误，通过此调用，将本地时间作为夏令时输出。WR_LOC_T： 写入本地时间(S7-1200, S7-1500) 说明 指令“WR_LOC_T”用于设置 CPU 时钟的日期和时间。在输入参数 LOCTIME中，输入日期和时 间作为本地时间。 输入值必须介于以下范围内： • DTL：Zui小值为DTL#1970-01-01-00:00:00.0，Zui大值为 DTL#2200-12-31 23:59:59.999999999 •LDT：Zui小值为 LDT#1970-01-01-0:0:0.000000000，Zui大值为 LDT#2200-12-3123:59:59.999999999 本地时间和系统时间的时间信息粒度与具体产品有关，且至少为 1 毫秒。对于 LOCTIME 参数中小于 CPU 所支持的值的输入值，将在系统计算期间进行上舍入。 可以在 RET_VAL输出参数中查询在执行该指令期间是否发生了错误。下表列出了“WR_LOC_T”指令的参数： 参数 声明 数据类型 存储区 说明S7-1200 S7-1500 LOCTIME Input DTL DTL, LDT I、Q、M、D、 L、P 或常量 * 本地时间DST Input BOOL BOOL I、Q、M、D、 L、P、T、C 或 常量 Daylight Saving Time仅在“双重小时值”期间时钟更 改为标准时间时才进行求值。 • TRUE = 夏令时（第一个小时 值） • FALSE =标准时间（第二个小 时值） RET_VAL Return INT INT I、Q、M、D、 L、P 错误消息（参见“RET_VAL 参数”） * 数据类型 DTL 无法用于以下存储区：输入、输出和位存储器。 有关有效数据类型的更多信息，请参见“有效数据类型概述(页 255)”。 参数 DST (Daylight Saving Time) 仅当从夏令时切换为标准时间时，才会对参数DST 进行评估： • 从夏令时切换到标准时间时，使用 DST 进行评估 在 3 a.m 时，时钟向后设置 (1)一个小时。即，02:00:00:000000000 AM 和 02:59:59:999999999 AM 之间间隔了两个小时。因此，对于 LOCTIME 中所有介于 02:00:00:000000000 AM 和 02:59:59:999999999 AM之间的时间，需要声明该时间是在时间切换之前还是之后。DST 参数的用法如下所示： – DST=TRUE时，该时间为两小时中的第一个小时。即，仍为夏令时时间。 – DST=FALSE 时，该时间为两小时中的第二个小时。即，为标准时间。对于 LOCTIME 中这两小时之外的所有时间，DST 将无关。 • 从标准时间切换到夏令时 参数 DST与标准时间到夏令时之间的切换无关。 在 2 a.m 时，时钟向前设置 (1) 一个小时。即，02:00:00:000000000 AM和 02:59:59:999999999 AM 之间不含任何小时间隔。 如果在 LOCTIME处指定该小时内的某个时间，则将输出错误代码 W#16#8089。