Android/Java中文环境下为何将周日设为一周首日？代码正确性求证

问题描述 #

我用以下改编自Jetpack Compose DatePicker的代码，试图获取对区域设置敏感的firstDayOfWeek索引，但在中文语言环境下，一周首日仍显示为周日，和英文环境一致——这不符合中国用户的认知，因为通用规则里中国将周一视为一周的第一天。

代码如下：

class WeekdayName(val locale:Locale) {

    fun dayInISO8601(day: Int): Int {
        val shiftedDay = (day + 6) % 7
        return if (shiftedDay == 0) /* Sunday */ 7 else shiftedDay
    }

    val firstDayOfWeek: Int =
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            WeekFields.of(locale).firstDayOfWeek.value
        } else {
            dayInISO8601(Calendar.getInstance(locale).firstDayOfWeek)
        }
}

请问这段获取firstDayOfWeek的代码是否正确？这是Android的预期行为吗？

问题解析与回答 #

代码逻辑无错误，问题源于系统历史遗留行为 #

你的代码逻辑是正确的，出现不符合预期结果的原因在于Android系统对中文Locale的日期规则处理：

• Android 8.0（API 26）之前版本：Calendar.getInstance(locale)针对中文Locale（如zh_CN），默认返回的firstDayOfWeek为周日（Calendar.SUNDAY），这是早期系统的历史遗留行为，未遵循中文地区的一周首日规则。
• Android 8.0及以上版本：虽然引入了WeekFields来规范区域日期规则，但部分设备或系统版本仍沿用旧行为，内置区域数据未正确适配中文地区将周一作为一周首日的设定。
• Jetpack Compose DatePicker的关联问题：DatePicker底层依赖Android系统日期组件逻辑，因此会继承这个不符合预期的行为。

适配解决方案 #

要符合中国用户认知，建议针对中文Locale做特殊处理，不要完全依赖系统返回结果：

class WeekdayName(val locale: Locale) {

    fun dayInISO8601(day: Int): Int {
        val shiftedDay = (day + 6) % 7
        return if (shiftedDay == 0) /* Sunday */ 7 else shiftedDay
    }

    val firstDayOfWeek: Int =
        // 针对中文Locale手动设置周一为一周首日（ISO 8601中周一为1）
        if (locale.language == "zh") {
            1
        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            WeekFields.of(locale).firstDayOfWeek.value
        } else {
            dayInISO8601(Calendar.getInstance(locale).firstDayOfWeek)
        }
}

内容的提问来源于stack exchange，提问作者bilabila