Carbon项目中的土库曼语星期名称偏移问题解析

在日期时间处理库Carbon中，土库曼语(Turkmen)的星期名称翻译存在一个系统性偏移问题。这个问题最初由用户allanur在2025年2月17日报告，随后被仓库协作者kylekatarnls确认并计划在下一个版本中修复。

问题描述

当前实现中，土库曼语的星期名称整体向后偏移了一天。具体表现为：

• 星期一(Sişenbe)实际上应该是星期二
• 星期二(Çarşenbe)应该是星期三
• 以此类推，直到星期日(Duşenbe)应该是星期一

这种偏移导致所有土库曼语的星期名称都比实际对应的星期多了一天，这在日期处理和显示时会产生错误的结果。

技术分析

星期名称的偏移通常源于两个可能的原因：

1. 基础数据录入错误：在最初实现土库曼语本地化时，可能错误地将星期名称数组的起始索引设置错误
2. 文化差异误解：可能混淆了土库曼语中星期命名的惯例与其他突厥语族的区别

在Carbon这样的国际化库中，星期名称通常以数组形式存储，索引0对应星期日或星期一(取决于地区惯例)。土库曼语作为突厥语族语言，其星期命名遵循"x+şenbe"的模式，其中"şenbe"源自波斯语"shanbe"(星期六)，但现代土库曼语中它表示星期五。

解决方案

正确的土库曼语星期名称对应关系应为：

英文	土库曼语	缩写
Monday	Duşenbe	Duş
Tuesday	Sişenbe	Siş
Wednesday	Çarşenbe	Çar
Thursday	Penşenbe	Pen
Friday	Anna	Ann
Saturday	Şenbe	Şen
Sunday	Ýekşenbe	Ýek

修复方案包括：

1. 重新排列星期名称数组，确保索引与ISO标准(星期一为0)或地区惯例一致
2. 更新对应的缩写形式
3. 确保所有相关的本地化函数和格式化器使用修正后的数据

影响范围

这个问题会影响：

• 使用Carbon处理土库曼语日期格式化的所有应用
• 依赖星期名称进行业务逻辑的土库曼语用户
• 涉及土库曼语日期显示的国际化应用

最佳实践

对于需要处理多语言日期显示的开发者，建议：

1. 定期检查所使用的国际化库的更新日志
2. 对关键语言进行基本的正确性验证
3. 考虑编写单元测试来验证本地化输出的正确性
4. 关注目标语言社区的反馈

这个问题的修复将提升Carbon库在土库曼语地区的可靠性，确保日期处理功能的准确性。对于使用Carbon的开发者来说，及时更新到包含此修复的版本将避免潜在的日期显示错误。