时间周期配置指南 ⏰

什么是时间周期格式？ 🤔

想象时间周期就像是一个时间计划表：

• 📅 年月日（就像日历上的日期）
• ⏲️ 时分秒（就像钟表上的时间）
• ➕ 正向时间（向未来计算）
• ➖ 负向时间（向过去计算）

ISO-8601格式说明 📝

基本格式

PnYnMnDTnHnMnS

就像搭积木一样，由以下部分组成：

符号	含义	示例	说明
P	Period（周期）	P	必须，表示这是一个周期
nY	Years（年）	1Y	1年
nM	Months（月）	2M	2个月
nD	Days（天）	10D	10天
T	Time（时间标记）	T	日期和时间的分隔符
nH	Hours（小时）	2H	2小时
nM	Minutes（分钟）	30M	30分钟
nS	Seconds（秒）	15S	15秒

使用规则 📌

1. 基本规则

   • ✓ 必须以 P 开头
   • ✓ 日期和时间之间用 T 分隔
   • ✓ 可以使用大写或小写（推荐大写）
   • ✓ 负数使用 - 表示

2. 灵活组合

   • ✓ 可以只使用需要的部分
   • ✓ 顺序必须是：年、月、日、时、分、秒
   • ✓ 数值可以包含小数

常用示例 💡

1. 简单时间

PT20S      # ⏱️ 20秒
PT15M      # ⏱️ 15分钟
PT10H      # ⏱️ 10小时
P2D        # 📅 2天

2. 组合时间

P2DT3H4M   # 📅 2天3小时4分钟
P1Y2M10D   # 📅 1年2个月10天
P1MT2H     # 📅 1个月零2小时

3. 负向时间

P-6H3M     # ⏰ 减6小时加3分钟
-P6H3M     # ⏰ 减6小时减3分钟
-P1Y       # 📅 减1年

最佳实践 💫

1. 可读性建议

   • ✓ 使用大写字母
   • ✓ 适当使用空格分隔
   • ✓ 选择合适的时间单位

2. 性能考虑

   • ✓ 避免过短的时间周期
   • ✓ 合理设置时间间隔
   • ✓ 注意时区影响

常见问题 ❓

1. 格式错误？

检查以下几点：

• ✓ 是否以 P 开头
• ✓ 时间部分是否有 T 分隔
• ✓ 单位是否正确

2. 计算异常？

解决方案：

• ✓ 检查正负号使用
• ✓ 验证时间单位顺序
• ✓ 确认数值范围

需要帮助？🆘

如果遇到问题：

1. 检查配置格式
2. 查看错误日志
3. 使用在线工具验证
4. 联系技术支持