Android MaterialDatePicker 如何限制选择跨度不超过3个月？

要实现允许用户选择任意过去的日期区间，同时限制区间跨度最多为3个月，核心是自定义日期验证逻辑，替代默认的范围限制。以下是具体实现步骤：

1. 自定义日期区间验证器 #

实现Material Date Picker的DateValidator<Pair<Long, Long>>接口，在验证逻辑中同时满足两个条件：

• 起始、结束日期均为过去日期（不晚于今日）
• 结束日期与起始日期的跨度不超过3个月

Kotlin 实现 #

import com.google.android.material.datepicker.DateValidator
import java.time.LocalDate
import java.time.temporal.ChronoUnit
import androidx.core.util.Pair

class Max3MonthsPastRangeValidator : DateValidator<Pair<Long, Long>> {
    private val today = LocalDate.now()

    override fun isValid(value: Pair<Long, Long>?): Boolean {
        if (value == null) return false
        
        // 将时间戳转换为LocalDate（单位：毫秒转天）
        val startDate = LocalDate.ofEpochDay(value.first / 86400000)
        val endDate = LocalDate.ofEpochDay(value.second / 86400000)

        // 验证1：日期不能晚于今日
        if (startDate.isAfter(today) || endDate.isAfter(today)) {
            return false
        }
        
        // 验证2：区间跨度不超过3个月
        val monthsBetween = ChronoUnit.MONTHS.between(startDate, endDate)
        return monthsBetween in 0..3 // 确保结束日期不早于起始，且跨度≤3个月
    }
}

Java 实现 #

import com.google.android.material.datepicker.DateValidator;
import java.time.LocalDate;
import java.time.temporal.ChronoUnit;
import androidx.core.util.Pair;
import androidx.annotation.Nullable;

public class Max3MonthsPastRangeValidator implements DateValidator<Pair<Long, Long>> {
    private final LocalDate today = LocalDate.now();

    @Override
    public boolean isValid(@Nullable Pair<Long, Long> value) {
        if (value == null) return false;
        
        LocalDate startDate = LocalDate.ofEpochDay(value.first / 86400000);
        LocalDate endDate = LocalDate.ofEpochDay(value.second / 86400000);

        if (startDate.isAfter(today) || endDate.isAfter(today)) {
            return false;
        }

        long monthsBetween = ChronoUnit.MONTHS.between(startDate, endDate);
        return monthsBetween >= 0 && monthsBetween <= 3;
    }
}

2. 配置日期选择器并应用验证器 #

创建Material日期区间选择器，将自定义验证器传入即可：

Kotlin 代码 #

val datePicker = MaterialDatePicker.Builder.dateRangePicker()
    .setTitleText("选择日期区间")
    .setDateValidator(Max3MonthsPastRangeValidator())
    .build()

datePicker.show(supportFragmentManager, "DATE_PICKER")

Java 代码 #

MaterialDatePicker<Pair<Long, Long>> datePicker = MaterialDatePicker.Builder.dateRangePicker()
        .setTitleText("选择日期区间")
        .setDateValidator(new Max3MonthsPastRangeValidator())
        .build();

datePicker.show(getSupportFragmentManager(), "DATE_PICKER");

3. 兼容Java 8时间API（可选） #

如果项目未启用Java 8时间API支持，需在build.gradle中添加配置：

android {
    compileOptions {
        coreLibraryDesugaringEnabled true
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.0.4'
}

这样配置后，用户可以选择任意过去的起始日期，只要结束日期在起始日期的3个月范围内且不晚于今日，完全满足需求。

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