时间周期配置指南

提示

本文档详细介绍了在网关中使用的时间周期格式，帮助您正确配置和使用时间相关功能。

时间周期格式概述

时间周期（Duration）是一个精确到纳秒的时间段。它使用简单直观的字符串表示方式，例如：300ms、2h45m等。

基本格式说明

时间单位

单位	说明	示例
ns	纳秒	1ns
µs	微秒	1µs
ms	毫秒	1ms
s	秒	1s
m	分钟	1m
h	小时	1h

格式规则

• 数字后面直接跟单位，不需要空格
• 可以组合多个时间单位
• 单位区分大小写
• 支持小数形式

常用示例

1. 基本时间表示

300ms      // 300毫秒
1.5h       // 1.5小时
2h30m      // 2小时30分钟
-1h30m     // 负1小时30分钟
1m30s      // 1分钟30秒

2. 组合时间表示

24h        // 一天
168h       // 一周
2h30m45s   // 2小时30分钟45秒
300ms20s   // 20.3秒

最佳实践

1. 可读性建议

• 使用最适合的时间单位
• 合理组合时间单位
• 避免过长的组合

// 推荐
2h30m      // 清晰直观
// 不推荐
150m       // 不够直观
9000s      // 难以理解

常见问题及解决方案

1. 解析错误

常见原因：

• 单位书写错误
• 格式不规范
• 数值范围超限

解决方案：

// 常见错误示例
"2:30"      // 错误：不支持冒号格式
"2 h 30 m"  // 错误：不能有空格
"2hours"    // 错误：单位不正确

2. 计算问题

注意事项：

• 溢出检查
• 精度损失
• 时区影响

注意

• Duration类型最大支持约290年
• 进行时间计算时注意溢出问题
• 跨时区操作需要特别注意