计时器检查
<h1>计时器检查</h1>
<h2>功能描述</h2>
<p>检查或初始化计时器,支持延迟触发和间隔触发逻辑。</p>
<h2>输入参数</h2>
<ul>
<li><strong>计时器名称</strong>:字符串(必填,如 <code>&quot;timer1&quot;</code>)。</li>
<li><strong>延迟(秒)</strong>:数字(可选,如 <code>5</code>)。</li>
<li><strong>间隔(秒)</strong>:数字(可选,如 <code>10</code>)。</li>
<li><strong>默认关闭</strong>:布尔值(可选,如 <code>true</code>)。</li>
</ul>
<h2>输出结果</h2>
<ul>
<li><strong>执行结果</strong>:
- <code>true</code>(触发成功时)。
- <code>false</code>(触发失败时)。</li>
</ul>
<h2>日志记录</h2>
<ul>
<li>输入参数:
- <code>计时器名称: &quot;timer1&quot;</code>
- <code>延迟(秒): 5</code>
- <code>间隔(秒): 10</code>
- <code>默认关闭: true</code></li>
<li>输出结果:
- <code>执行结果: true</code> 或 <code>false</code></li>
<li>日志信息:
- <code>首次触发: 延迟(秒)[5], 计划触发时间[2025-10-02 15:30:00]</code>(初始化时)。
- <code>间隔检查: 触发成功, 下次触发时间[2025-10-02 15:30:10]</code>(触发成功时)。
- <code>间隔检查: 未触发, 剩余时间[3.50秒]</code>(未触发时)。
- <code>无效计时器名称: timer1</code>(失败时)。</li>
</ul>
<h2>示例</h2>
<h3>场景 1:首次触发</h3>
<ul>
<li><strong>输入参数</strong>:
- 计时器名称:<code>&quot;timer1&quot;</code>
- 延迟(秒):<code>5</code>
- 间隔(秒):<code>10</code>
- 默认关闭:<code>false</code></li>
<li><strong>输出结果</strong>:
- <code>执行结果: false</code>(首次触发时仅计划触发时间)。</li>
<li><strong>日志输出</strong>:
- <code>首次触发: 延迟(秒)[5], 计划触发时间[2025-10-02 15:30:00]</code></li>
</ul>
<h3>场景 2:间隔触发成功</h3>
<ul>
<li><strong>输入参数</strong>:
- 计时器名称:<code>&quot;timer1&quot;</code>
- 间隔(秒):<code>10</code></li>
<li><strong>输出结果</strong>:
- <code>执行结果: true</code>(触发成功时)。</li>
<li><strong>日志输出</strong>:
- <code>间隔检查: 触发成功, 下次触发时间[2025-10-02 15:30:10]</code></li>
</ul>