如何在Android中使用MaterialDatePicker禁用未来日期？

现有代码的核心问题 #

• 月份索引偏差：Android 中 Calendar 的月份字段从 0 开始计数，0 对应 1 月、1 对应 2 月，代码里设置 startMonth = 1 实际对应的是2月1日，和预期的1月起始边界存在整整1个月的偏移。
• 最大日期硬编码失效：代码将可选最大日期写死为 2021年3月27日，既没有动态读取当前系统日期，也完全偏离“禁用所有未来日期”的需求，会导致2021年3月28日及之后的所有日期都处于不可选状态，表现和预期完全不符。
• 时间边界精度误差：直接使用 Calendar.getInstance() 的默认时间戳做边界值，没有清理自带的时分秒毫秒值，很容易出现临近边界的日期被误判为不可选的问题。

修正后的可运行实现 #

直接替换原有limitRange()方法逻辑即可，核心是动态计算当天的最晚时间戳作为最大可选边界，消除时间精度带来的误差：

private fun limitRange(): CalendarConstraints.Builder {
    // 最小可选日期：1900年1月1日，清除默认时分秒避免边界判定偏差
    val minDateCalendar = Calendar.getInstance().apply {
        clear()
        set(1900, Calendar.JANUARY, 1)
    }
    // 最大可选日期：当天的23:59:59.999，完整放开当天的选择权限，所有晚于该时间的未来日期自动禁用
    val maxDateCalendar = Calendar.getInstance().apply {
        set(Calendar.HOUR_OF_DAY, 23)
        set(Calendar.MINUTE, 59)
        set(Calendar.SECOND, 59)
        set(Calendar.MILLISECOND, 999)
    }

    val minValidTime = minDateCalendar.timeInMillis
    val maxValidTime = maxDateCalendar.timeInMillis

    val constraintsBuilder = CalendarConstraints.Builder()
    // 组合校验规则：仅允许选择 [最小日期, 最大日期] 闭区间内的有效时间
    val rangeValidator = CompositeDateValidator.allOf(
        listOf(
            DateValidatorPointForward.from(minValidTime),
            DateValidatorPointBackward.before(maxValidTime)
        )
    )

    constraintsBuilder.setValidator(rangeValidator)
    return constraintsBuilder
}

实用优化提示 #

• 直接使用Calendar.JANUARY这类系统常量指代月份，从根源上避免硬编码月份数字导致的索引偏移问题。
• 最大日期设置为当天的最晚时刻，可避免用户打开选择器时发现当天日期因时间戳判定被误禁用的体验问题。
• 对最小日期调用clear()方法，消除初始化Calendar时自带的当前时分秒毫秒值，保证最小边界为当日0点整，不会漏掉起始日期的选择权限。
• 如果需要选择器打开时直接定位到当前月份，可额外调用setOpenAt(maxValidTime)方法，让选择器启动时停留在当月视图，减少用户的长距离滑动操作。

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