Kimai时间记录导入中的时长舍入问题分析

问题背景

在Kimai时间跟踪系统中，用户从Clockify导入时间记录数据时发现了一个关于时长计算的舍入问题。具体表现为：当导入包含非整小时的时间记录时，系统显示的时间与原始数据存在差异。

问题现象

以一个具体案例为例：

• 开始时间：10:01
• 结束时间：10:42
• 实际时长应为1小时41分钟（1.6833小时）

但在导入后，系统显示为1小时40分钟，与预期不符。数据库存储的秒数为6059秒，而正确值应为6060秒。

技术分析

问题根源

问题主要出现在两个处理环节：

1. 导入处理阶段：

   • 系统使用Duration::parseDecimalFormat函数处理十进制格式的时长
   • 计算过程：1.6833 × 3600 = 6059.88秒 → 强制转换为整数后得到6059秒（舍去小数部分）

2. 显示处理阶段：

   • 使用Duration::format函数格式化显示时长
   • 计算过程：6059秒 → 1小时40分钟（再次向下取整）

解决方案比较

用户提出了两种解决方案：

1. 使用Clockify的"Duration (h)"字段：

   • 该字段直接提供"时:分"格式的时长（如1:41）
   • 避免了十进制转换过程中的舍入问题
   • 经测试可正确导入和显示

2. 修改系统舍入规则：

   • 尝试调整系统偏好设置中的舍入规则
   • 但发现舍入规则不适用于导入过程

最佳实践建议

对于需要从Clockify导入数据到Kimai的用户，建议：

1. 在导入配置中选择"Duration (h)"作为时长字段
2. 避免使用"Duration (decimal)"字段，以防止舍入误差
3. 对于已导入的错误数据，可通过批量编辑功能进行修正

技术启示

这个问题揭示了时间数据处理中的几个重要原则：

1. 时间数据的精度处理需要特别谨慎，特别是涉及多级转换时
2. 不同系统间的数据交换应优先考虑保持原始格式，避免不必要的转换
3. 用户界面显示逻辑应与数据存储逻辑保持一致

Kimai开发团队已在新版本中修复了此问题，用户只需更新到最新版导入插件即可获得正确的导入体验。