Kotlin中DatePickerDialog月份值比选中值少1的原因及解决办法

原因分析 #

• Android的DatePickerDialog回调返回的月份是**0索引（0-based）**的，这和java.util.Calendar的设计完全一致：0对应1月，1对应2月……11对应12月。
• 你的代码核心错误：直接将0-based的月份值拼入日期字符串，再用SimpleDateFormat("dd/MM/yyyy")解析——MM格式要求的是1-12的1索引月份值。当解析0时，SimpleDateFormat会自动调整日期：将无效的0月视为上一年的12月，这就导致选中1月时，解析后变成上一年的12月；而选中12月时，回调返回11，解析后显示为11月，和实际选中的12月不符。

修复方法 #

方法1：修复现有旧API代码 #

方式A：修正月份后再拼接字符串

在拼接日期字符串前，给selectedMonth加1，转换成1-based的合法月份值：

fun pickDate() {
    val cal = Calendar.getInstance()
    val year = cal.get(Calendar.YEAR)
    val month = cal.get(Calendar.MONTH)
    val day = cal.get(Calendar.DAY_OF_MONTH)
    DatePickerDialog(this,
        DatePickerDialog.OnDateSetListener { view, selectedYear, selectedMonth, selectedDay ->
            // 将0-based月份转为1-based
            val correctedMonth = selectedMonth + 1
            val selectedDate = "$selectedDay/$correctedMonth/$selectedYear"
            val sdf = SimpleDateFormat("dd/MM/yyyy", Locale.ENGLISH)
            // 实际开发中建议用try-catch包裹ParseException
            val formattedDate = sdf.format(sdf.parse(selectedDate))
            dateText?.text = formattedDate.toString()
        },
        year,
        month,
        day
    ).show()
}

方式B：直接用Calendar构建日期（更安全）

避免字符串解析的潜在问题，直接通过Calendar类构建正确日期：

fun pickDate() {
    val cal = Calendar.getInstance()
    val year = cal.get(Calendar.YEAR)
    val month = cal.get(Calendar.MONTH)
    val day = cal.get(Calendar.DAY_OF_MONTH)
    DatePickerDialog(this,
        DatePickerDialog.OnDateSetListener { view, selectedYear, selectedMonth, selectedDay ->
            val resultCal = Calendar.getInstance().apply {
                set(Calendar.YEAR, selectedYear)
                set(Calendar.MONTH, selectedMonth) // 直接传入0-based月份，Calendar内部处理逻辑匹配
                set(Calendar.DAY_OF_MONTH, selectedDay)
            }
            val sdf = SimpleDateFormat("dd/MM/yyyy", Locale.ENGLISH)
            val formattedDate = sdf.format(resultCal.time)
            dateText?.text = formattedDate.toString()
        },
        year,
        month,
        day
    ).show()
}

方法2：使用更可靠的Java 8+日期API（推荐） #

旧的Calendar和SimpleDateFormat存在线程不安全、API设计混乱等问题，推荐使用Android支持的java.time API（Android 8.0+原生支持，更低版本可通过Core Library Desugaring兼容）：

import java.time.LocalDate
import java.time.format.DateTimeFormatter

fun pickDate() {
    val now = LocalDate.now()
    DatePickerDialog(this,
        DatePickerDialog.OnDateSetListener { view, selectedYear, selectedMonth, selectedDay ->
            // LocalDate.of的月份参数是1-based，所以给selectedMonth加1
            val selectedDate = LocalDate.of(selectedYear, selectedMonth + 1, selectedDay)
            val formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy", Locale.ENGLISH)
            val formattedDate = selectedDate.format(formatter)
            dateText?.text = formattedDate
        },
        now.year,
        now.monthValue - 1, // DatePickerDialog需要0-based月份，所以减1
        now.dayOfMonth
    ).show()
}

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