DataLogClear： 清空数据日志 (S7-1200, S7-1500) 说明 指令“DataLogClear”可删除现有数据记录中的所有数据记录。该指令不会删除 CSV 文件的可 选标题（请参见指令“DataLogCreate ”的 HEADER 参数说明）。 通过参数 ID，可选择待删除数据记录的数据日志。 要求 删除数据记录前，必须打开数据记录（请参见“DataLogOpen 指令”）。 参数 下表列出了“DataLogClear”指令的参数： 参数 声明 数据类型 存储区 说明 REQ Input BOOL I、Q、M、L、D、 T、C 或常量 （对于 S7-1500，T 和 C 只能在 LAD 和 FBD 中使用） 在上升沿执行指令。 ID InOut DWORD I、Q、M、D、L 数据日志的对象 ID DONE Output BOOL I、Q、M、D、L 指令已成功执行。 BUSY Output BOOL I、Q、M、D、L 指令的执行尚未完成。

            DataLogWrite： 写数据日志 (S7-1200, S7-1500) 说明 通过“DataLogWrite”指令，可将数据记录写入当前的数据日志中。通过 ID 参数，可选择待写 入数据记录的数据日志。要创建新数据记录，必须打开数据记录。该指令将创建一条新的数 据记录，在创建数据记录时并通过 DATA 参数指定其格式。 在调用“DataLogWrite”指令之前，请将数据传送到“DataLogCreate”指令的 DATA 参数处互连 的变量。执行“DataLogWrite”指令时，传送的数据将复制到数据记录中。 注意 当断开 CPU 电源时，数据记录的数据将会丢失 如果在执行“DataLogWrite”指令时断开电源，将丢失要传送的数据记录。 参数 下表列出了“DataLogWrite”指令的参数： 参数 声明 数据类型 存储区 说明 REQ Input BOOL I、Q、M、L、D、 T、C 或常量 （对于 S7-1500， T 和 C 只能在 LAD 和 FBD 中使用） 在上升沿执行指令。 ID InOut DWORD I、Q、M、L、D 数据日志的对象 ID DONE Output BOOL I、Q、M、L、D 指令已成功执行。 BUSY Output BOOL I、Q、M、L、D 指令的执行尚未完成。 ERROR Output BOOL I、Q、M、L、D • 0：无错误。 • 1：指令执行过程中发生错误。 详细信息将在 STATUS 参数中输出。 STATUS Output WORD I、Q、M、L、D 状态参数 该参数设置仅维持一次调用所持续的时间。因 此，要显示其状态，应将 STATUS 参数复制到 可用数据区域。 有关有效数据类型的更多信息，请参见“有效数据类型概述DataLogClose： 关闭数据日志 (S7-1200, S7-1500) 说明 通过“DataLogClose”指令，可关闭一个打开的数据日志。使用 ID 参数，选择数据日志。 说明 自动关闭数据日志 当 CPU 转入 STOP 模式或重启时，将自动关闭数据日志。 参数 下表列出了“DataLogClose”指令的参数： 参数 声明 数据类型 存储区 说明 REQ Input BOOL I、Q、M、L、D、 T、C 或常量 （对于 S7-1500，T 和 C 只能在 LAD 和 FBD 中使用） 在上升沿执行功能。 ID InOut DWORD I、Q、M、L、D 数据日志的对象 ID DONE Output BOOL I、Q、M、L、D 指令已成功执行。 BUSY Output BOOL I、Q、M、L、D 指令的执行尚未完成。 ERROR Output BOOL I、Q、M、L、D • 0：无错误。 • 1：指令执行过程中发生错误。 详细信息将在 STATUS 参数中输出。 STATUS Output WORD I、Q、M、L、D 状态参数 该参数设置仅维持一次调用所持续的时间。 因此，要显示其状态，应将 STATUS 参数复 制到可用数据区域。DataLogDelete： 删除数据日志 (S7-1200, S7-1500) 说明 使用“DataLogDelete”指令，可以删除存储卡上的数据记录文件。仅当使用指令 “DataLogCreate”或“DataLogNewFile”创建数据日志和包含的数据记录时，才能将其删除。 参数 下表列出了“DataLogDelete”指令的参数： 参数 声明 数据类型 存储区 说明 REQ Input BOOL I、Q、M、L、D、 T、C 或常量 （对于 S7-1500，T 和 C 只能在 LAD 和 FBD 中使用） 在上升沿执行指令。 NAME Input VARIANT L、D 数据记录的文件名 DELFILE Input BOOL I、Q、M、D、L 或 常量 • 0：将保留数据记录。 • 1：将删除数据记录。 ID InOut DWORD I、Q、M、D、L 数据日志的对象 ID DONE Output BOOL I、Q、M、D、L 指令已成功执行。 BUSY Output BOOL I、Q、M、D、L 尚未完成数据记录的删除。 ERROR Output BOOL I、Q、M、D、L • 0：无错误。 • 1：指令执行过程中发生错误。 详细信息将在 STATUS 参数中输出。 STATUS Output WORD I、Q、M、D、L 状态参数 该参数设置仅维持一次调用所持续的时 间。因此，要显示其状态，应将 STATUS 参数复制到可用数据区域。 有关有效数据类型的更多信息，请参见“有效数据类型概述。参数 NAME 和 ID 使用 NAME 和 ID 参数选择要删除的数据记录。首先，对 ID 参数求值。如果存在相关 ID 的 数据记录，则将不会再判断 NAME 参数。如果 ID 参数中使用值“0”，则 NAME 参数中必须使 用数据类型为 STRING 的值。DataLogNewFile： 新文件中的数据日志 (S7-1200, S7-1500) DataLogNewFile： 新文件中的数据日志 (S7-1200) 说明 通过“DataLogNewFile”指令，可创建一个属性与现有数据日志相同的新数据日志。这将允许 保留现有数据记录的内容。 调用时，该指令将在存储卡中或内部装载存储器中创建一个新的数据记录，日志名称在 NAME 参数中已定义。ID 参数用于指定旧数据记录的 ID，该数据记录的属性将应用于新的数据记录。 随后，新数据记录的 ID 将通过 ID 参数输出。 通过该指令的 RECORDS 参数，可以指定新数据记录的文件大小。 创建新数据记录后，将自动打开该文件。这表示可写入数据。 参数 下表列出了“DataLogNewFile”指令的参数： 参数 声明 数据类型 存储区 说明 REQ Input BOOL I、Q、M、L、D 或 常量 在上升沿执行指令。 RECORDS Input UDInt I、Q、M、L、D 或 常量 数据记录中的数据记录数目。 NAME Input VARIANT L、D 新数据记录的文件名。 ID InOut DWORD I、Q、M、L、D 数据日志的对象 ID • 输入：当前数据记录的 ID • 输出：新数据记录的 ID DONE Output BOOL I、Q、M、L、D 指令已成功执行。 BUSY Output BOOL I、Q、M、L、D 指令的执行尚未完成。DataLogNewFile： 新文件中的数据日志 (S7-1500) 说明 通过“DataLogNewFile”指令，可创建一个属性与现有数据日志相同的新数据日志。这将允许 保留现有数据记录的内容。 调用时，该指令将在存储卡中或内部装载存储器中创建一个新的数据记录，日志名称在 NAME 参数中已定义。ID 参数用于指定旧数据记录的 ID，该数据记录的属性将应用于新的数据记录。 随后，新数据记录的 ID 将通过 ID 参数输出。 通过该指令的 RECORDS 参数，可以指定新数据记录的文件大小。 通过 DATA 参数可以检查要创建的新数据记录是否与“DataLogCreate (页 3303)”指令的数据 记录定义一致。此时，系统将检查参数 DATA 的数据类型是否与“DataLogCreate”的数据类型 相同。如果不相同，则在参数 STATUS 处输出错误代码 W#16#80A0。 创建新数据记录后，将自动打开该文件。这表示可写入数据。下表列出了“DataLogNewFile”指令的参数： 参数 声明 数据类型 存储区 说明 REQ Input BOOL I、Q、M、L、D、 T、C 或常量 （对于 S7-1500，T 和 C 只能在 LAD 和 FBD 中使用） 在上升沿执行指令。 RECORDS Input UDInt I、Q、M、L、D 或 常量 数据记录中的数据记录数目。 NAME Input VARIANT L、D 新数据记录的文件名。 ID InOut DWORD I、Q、M、L、D 数据日志的对象 ID • 输入：当前数据记录的 ID • 输出：新数据记录的 ID DATA InOut VARIANT D 进行一致性检查的数据类型 DONE Output BOOL I、Q、M、L、D 指令已成功执行。 BUSY Output BOOL I、Q、M、L、D 指令的执行尚未完成。 ERROR Output BOOL I、Q、M、L、D • 0：无错误。 • 1：指令执行期间出现错误。 详细信息将在 STATUS 参数中输出。 STATUS Output WORD I、Q、M、L、D 状态参数 该参数设置仅维持一次调用所持续的时间。因 此，要显示其状态，应将 STATUS 参数复制到可 用数据区域。 有关有效数据类型的更多信息，请参见“有效数据类型概述。