Immich-Go 时间戳解析时区问题解析

问题背景

在使用 Immich-Go 工具进行图片上传时，许多用户发现从文件名中解析出的时间戳总是被当作 UTC 时间处理，即使通过 -time-zone 参数指定了其他时区也无济于事。这个问题尤其影响那些文件名中包含本地时间戳的用户，导致照片的拍摄时间显示不正确。

技术分析

Immich-Go 在处理文件名中的时间戳时，存在以下技术实现细节：

1. 时间解析机制：系统能够识别 YYYY-MM-DD_hh-mm-ss.png 这类标准格式的文件名
2. 时区处理：在代码实现中，解析出的时间戳被强制设置为 UTC 时区，忽略了用户指定的时区参数
3. 参数传递：-time-zone 参数虽然存在，但未被应用到文件名时间戳的解析过程中

影响范围

这个问题会导致：

• 文件名中包含本地时间戳的图片在上传后显示的时间比实际时间提前或延后
• 用户无法通过时区参数校正时间显示
• 照片的时间线排序可能出现问题

解决方案

项目维护者已在 v0.23.0-RC8 版本中修复了这个问题。新版本中：

1. 正确应用了 -time-zone 参数
2. 文件名中的时间戳会根据用户指定的时区进行解析
3. 保持了向后兼容性

最佳实践建议

对于需要使用文件名时间戳功能的用户：

1. 确保使用最新版本的 Immich-Go
2. 明确指定 -time-zone 参数为您的本地时区
3. 保持文件名时间戳格式的一致性
4. 在上传前可以先进行小批量测试验证时间戳解析是否正确

总结

时间戳处理是照片管理工具的核心功能之一。Immich-Go 通过这次修复，完善了从文件名解析时间戳的时区处理逻辑，为用户提供了更准确的时间标记功能。用户升级到最新版本后，可以确保照片的时间信息得到正确记录和显示。