日期时间选择器实战：AndroidPicker DatePicker与TimePicker详解

【免费下载链接】AndroidPicker 安卓选择器类库，包括日期及时间选择器（可用于出生日期、营业时间等）、单项选择器（可用于性别、民族、职业、学历、星座等）、二三级联动选择器（可用于车牌号、基金定投日期等）、城市地址选择器（分省级、地市级及区县级）、数字选择器（可用于年龄、身高、体重、温度等）、日历选日期择器（可用于酒店及机票预定日期）、颜色选择器、文件及目录选择器、图片选择器等……WheelPicker/DatePicker/TimePicker/OptionPicker/NumberPicker/LinkagePicker/AddressPicker/CarPlatePicker/CalendarPicker/ColorPicker/FilePicker/ImagePicker etc. 项目地址: https://gitcode.com/gh_mirrors/an/AndroidPicker

本文全面解析了AndroidPicker库中DatePicker、TimePicker和DatimePicker三大核心组件的功能特性与实战应用。详细介绍了DatePicker的多种日期模式（年月日、年月、月日）、灵活的日期范围配置、标签自定义、格式化器实现以及联动行为控制；深入探讨了TimePicker对12/24小时制的完整支持机制，包括时间模式枚举、AM/PM智能处理和国际标准化实现；系统阐述了DatimePicker的日期时间联动架构设计、智能范围限制策略以及多模式组合应用。同时还提供了日期时间格式化与范围限制的最佳实践方案，包括自定义格式化器实现、智能范围限制策略、联动验证机制以及性能优化建议，为开发者提供了一套完整的日期时间选择解决方案。

DatePicker日期选择器的多种模式与配置

AndroidPicker的DatePicker组件提供了强大的日期选择功能，支持多种日期模式、灵活的配置选项以及丰富的自定义能力。通过DateWheelLayout控件，开发者可以轻松实现各种日期选择场景，从简单的年月日选择到复杂的日期范围控制。

日期模式详解

DatePicker支持三种主要的日期显示模式，通过setDateMode()方法进行配置：

// 设置日期模式为年月日（默认）
datePicker.getWheelLayout().setDateMode(DateMode.YEAR_MONTH_DAY);

// 设置日期模式为年月
datePicker.getWheelLayout().setDateMode(DateMode.YEAR_MONTH);

// 设置日期模式为月日
datePicker.getWheelLayout().setDateMode(DateMode.MONTH_DAY);

各种模式的应用场景如下表所示：

模式	常量值	显示内容	适用场景
年月日	DateMode.YEAR_MONTH_DAY	年、月、日	出生日期、完整日期选择
年月	DateMode.YEAR_MONTH	年、月	信用卡有效期、年月选择
月日	DateMode.MONTH_DAY	月、日	生日提醒、周年纪念日

日期范围配置

DatePicker提供了灵活的日期范围设置功能，可以精确控制用户可选择的日期范围：

// 设置日期范围（起始日期和结束日期）
DateEntity startDate = DateEntity.target(2020, 1, 1);
DateEntity endDate = DateEntity.target(2030, 12, 31);
datePicker.getWheelLayout().setRange(startDate, endDate);

// 设置日期范围并指定默认值
DateEntity defaultValue = DateEntity.today();
datePicker.getWheelLayout().setRange(startDate, endDate, defaultValue);

日期范围配置支持多种便捷方法：

// 使用当前日期作为起始，未来30年作为结束
datePicker.getWheelLayout().setRange(DateEntity.today(), DateEntity.yearOnFuture(30));

// 设置特定日期范围
DateEntity customStart = DateEntity.target(2023, 6, 15);
DateEntity customEnd = DateEntity.target(2025, 8, 20);
datePicker.getWheelLayout().setRange(customStart, customEnd);

标签文本自定义

DatePicker允许开发者自定义各个日期部分的标签文本，以适应不同的语言或业务需求：

// 自定义年月日标签
datePicker.getWheelLayout().setDateLabel("年份", "月份", "日期");

// 自定义为英文标签
datePicker.getWheelLayout().setDateLabel("Year", "Month", "Day");

// 自定义为其他语言标签
datePicker.getWheelLayout().setDateLabel("년", "월", "일");

日期格式化器

通过实现DateFormatter接口，开发者可以完全控制日期的显示格式：

// 自定义日期格式化器
DateFormatter customFormatter = new DateFormatter() {
    @Override
    public String formatYear(int year) {
        return year + "年";
    }
    
    @Override
    public String formatMonth(int month) {
        return String.format("%02d月", month);
    }
    
    @Override
    public String formatDay(int day) {
        return String.format("%02d日", day);
    }
};

datePicker.getWheelLayout().setDateFormatter(customFormatter);

系统内置了多种格式化器：

// 使用简单格式化器（默认）
datePicker.getWheelLayout().setDateFormatter(new SimpleDateFormatter());

// 使用单位格式化器（添加单位后缀）
datePicker.getWheelLayout().setDateFormatter(new UnitDateFormatter());

联动行为控制

DatePicker支持灵活的联动行为配置，控制年月日之间的联动关系：

// 启用联动重置（默认行为）
// 当年份改变时，月份和日期会重置
datePicker.getWheelLayout().setResetWhenLinkage(true);

// 禁用联动重置
// 当年份改变时，保持原有的月份和日期选择
datePicker.getWheelLayout().setResetWhenLinkage(false);

联动行为的工作流程如下：

样式与外观配置

DatePicker提供了丰富的样式配置选项，可以自定义滚轮的外观：

DateWheelLayout wheelLayout = datePicker.getWheelLayout();

// 设置文本颜色和大小
wheelLayout.setTextColor(0xFF333333);
wheelLayout.setSelectedTextColor(0xFF0081FF);
wheelLayout.setTextSize(16f);
wheelLayout.setSelectedTextSize(18f);

// 设置指示器和幕布
wheelLayout.setIndicatorEnabled(true);
wheelLayout.setIndicatorColor(0xFFFF0000);
wheelLayout.setIndicatorSize(2f);
wheelLayout.setCurtainEnabled(true);
wheelLayout.setCurtainColor(0x220081FF);

// 设置滚轮效果
wheelLayout.setCurvedEnabled(true);
wheelLayout.setCurvedMaxAngle(90);
wheelLayout.setAtmosphericEnabled(true);

选择监听器

通过设置选择监听器，可以实时获取用户选择的日期信息：

datePicker.getWheelLayout().setOnDateSelectedListener(new OnDateSelectedListener() {
    @Override
    public void onDateSelected(Integer year, Integer month, Integer day) {
        // 实时处理日期选择
        if (year != null && month != null && day != null) {
            String selectedDate = String.format("%d-%02d-%02d", year, month, day);
            Log.d("DatePicker", "Selected date: " + selectedDate);
        }
    }
});

datePicker.setOnDatePickedListener(new OnDatePickedListener() {
    @Override
    public void onDatePicked(int year, int month, int day) {
        // 最终确认的日期选择
        String finalDate = String.format("%d年%d月%d日", year, month, day);
        Toast.makeText(MainActivity.this, "选择日期: " + finalDate, Toast.LENGTH_SHORT).show();
    }
});

XML布局配置

DatePicker也支持在XML布局文件中进行配置：

<com.github.gzuliyujiang.wheelpicker.widget.DateWheelLayout
    android:id="@+id/date_wheel_layout"
    android:layout_width="120dp"
    android:layout_height="150dp"
    app:wheel_dateMode="year_month_day"
    app:wheel_yearLabel="年"
    app:wheel_monthLabel="月"
    app:wheel_dayLabel="日"
    app:wheel_curtainEnabled="true"
    app:wheel_indicatorEnabled="true"
    app:wheel_textSize="16sp"
    app:wheel_selectedTextSize="18sp" />

完整配置示例

下面是一个完整的DatePicker配置示例，展示了各种配置选项的组合使用：

DatePicker datePicker = new DatePicker(this);
DateWheelLayout wheelLayout = datePicker.getWheelLayout();

// 基本配置
wheelLayout.setDateMode(DateMode.YEAR_MONTH_DAY);
wheelLayout.setDateLabel("年", "月", "日");

// 日期范围配置
DateEntity startDate = DateEntity.target(2000, 1, 1);
DateEntity endDate = DateEntity.target(2030, 12, 31);
DateEntity defaultDate = DateEntity.target(1995, 8, 15);
wheelLayout.setRange(startDate, endDate, defaultDate);

// 样式配置
wheelLayout.setResetWhenLinkage(true);
wheelLayout.setCurtainEnabled(true);
wheelLayout.setCurtainColor(0x330081FF);
wheelLayout.setIndicatorEnabled(true);
wheelLayout.setIndicatorColor(0xFF0081FF);

// 格式化配置
wheelLayout.setDateFormatter(new UnitDateFormatter());

// 事件监听
datePicker.setOnDatePickedListener(new OnDatePickedListener() {
    @Override
    public void onDatePicked(int year, int month, int day) {
        // 处理日期选择结果
    }
});

datePicker.show();

通过上述多种模式和配置选项，AndroidPicker的DatePicker组件能够满足各种复杂的日期选择需求，为开发者提供强大而灵活的日期选择解决方案。

TimePicker时间选择器的12/24小时制支持

在AndroidPicker库中，TimePicker组件提供了灵活的时间选择功能，其中最重要的特性之一就是对12小时制和24小时制的完整支持。这种支持不仅体现在显示格式上，还包括了完整的时间逻辑处理和用户交互体验。

时间模式枚举定义

AndroidPicker通过TimeMode注解定义了四种时间模式，为开发者提供了清晰的配置选项：

@Retention(RetentionPolicy.SOURCE)
public @interface TimeMode {
    int NONE = -1;                      // 不显示时间
    int HOUR_24_NO_SECOND = 0;          // 24小时制（不含秒）
    int HOUR_24_HAS_SECOND = 1;         // 24小时制（包括秒）
    int HOUR_12_NO_SECOND = 2;          // 12小时制（不含秒）
    int HOUR_12_HAS_SECOND = 3;         // 12小时制（包括秒）
}

12小时制的实现机制

当选择12小时制模式时，TimePicker会自动显示AM/PM选择器，并相应地调整小时数的显示逻辑：

// 在TimeWheelLayout中的关键实现代码
if (timeMode == TimeMode.HOUR_12_NO_SECOND
        || timeMode == TimeMode.HOUR_12_HAS_SECOND) {
    meridiemWheelView.setVisibility(View.VISIBLE);
    meridiemWheelView.setData(Arrays.asList("AM", "PM"));
}

这种设计确保了：

• AM/PM选择器只在12小时制模式下显示
• 小时数的范围自动调整为1-12
• 时间逻辑正确处理上午和下午的转换

24小时制的简洁实现

对于24小时制，TimePicker提供了更简洁的时间选择体验：

// 24小时制模式下隐藏AM/PM选择器
if (timeMode == TimeMode.HOUR_24_NO_SECOND
        || timeMode == TimeMode.HOUR_24_HAS_SECOND) {
    meridiemWheelView.setVisibility(View.GONE);
}

24小时制的特点包括：

• 小时数范围0-23
• 无需AM/PM选择，界面更简洁
• 符合国际标准时间表示法

配置和使用示例

开发者可以通过多种方式配置时间模式：

通过代码设置：

TimePicker timePicker = new TimePicker(this);
TimeWheelLayout wheelLayout = timePicker.getWheelLayout();

// 设置12小时制（不含秒）
wheelLayout.setTimeMode(TimeMode.HOUR_12_NO_SECOND);

// 或者设置24小时制（包含秒）
wheelLayout.setTimeMode(TimeMode.HOUR_24_HAS_SECOND);

通过XML属性配置：

<com.github.gzuliyujiang.wheelpicker.widget.TimeWheelLayout
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:wheel_timeMode="hour_12_no_second" />

时间格式转换逻辑

TimePicker内部实现了智能的时间格式转换：

默认值设置策略

设置默认值时，TimePicker会根据当前模式智能处理：

// 自动判断AM/PM状态
isAnteMeridiem = defaultValue.getHour() < 12 || defaultValue.getHour() == 24;
meridiemWheelView.setDefaultValue(isAnteMeridiem ? "AM" : "PM");

完整的时间选择流程

实际应用场景对比

场景	推荐模式	优势
国际化应用	HOUR_24_HAS_SECOND	符合国际标准，避免AM/PM混淆
日常生活	HOUR_12_NO_SECOND	符合日常习惯，界面友好
精确计时	HOUR_24_HAS_SECOND	提供秒级精度，24小时制清晰
简单时间选择	HOUR_12_NO_SECOND	操作简单，符合用户认知

回调处理机制

TimePicker提供了两种回调接口来处理不同格式的时间选择结果：

// 基本时间回调（适用于24小时制）
public interface OnTimePickedListener {
    void onTimePicked(int hour, int minute, int second);
}

// 带AM/PM信息的时间回调（适用于12小时制）
public interface OnTimeMeridiemPickedListener {
    void onTimePicked(int hour, int minute, int second, boolean isAnteMeridiem);
}

这种设计让开发者可以根据实际需求选择最合适的回调方式，确保时间数据的准确性和一致性。

AndroidPicker的TimePicker组件通过完善的12/24小时制支持，为开发者提供了灵活、可靠的时间选择解决方案，能够满足各种应用场景的需求。

DatimePicker日期时间联动选择器实现

AndroidPicker的DatimePicker是一个功能强大的日期时间联动选择器，它将DatePicker和TimePicker完美结合，为用户提供了一站式的日期时间选择体验。该组件支持多种日期和时间模式组合，具备智能联动功能，能够根据日期变化自动调整时间范围，确保选择的日期时间始终有效。

核心架构设计

DatimePicker采用组合模式设计，内部封装了DateWheelLayout和TimeWheelLayout两个核心组件，通过DatimeEntity实体类进行数据传递和协调。

布局结构解析

DatimePicker的UI布局采用水平线性布局，日期和时间选择器按权重比例分配空间：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:baselineAligned="false"
    android:orientation="horizontal">

    <DateWheelLayout
        android:id="@+id/wheel_picker_date_wheel"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_weight="1.2" />

    <TimeWheelLayout
        android:id="@+id/wheel_picker_time_wheel"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_weight="1.0" />

</LinearLayout>

这种设计确保了日期选择器获得更多的显示空间（权重1.2），时间选择器获得适当的空间（权重1.0），整体布局协调美观。

核心功能实现

1. 日期时间范围设置

DatimePicker支持灵活的日期时间范围设置，开发者可以指定起始时间、结束时间和默认值：

// 设置日期时间范围（当前时间到30年后）
wheelLayout.setRange(DatimeEntity.now(), DatimeEntity.yearOnFuture(30));

// 设置日期时间范围并指定默认值
wheelLayout.setRange(
    DatimeEntity.now(), 
    DatimeEntity.yearOnFuture(10),
    DatimeEntity.now()  // 默认值为当前时间
);

2. 模式配置支持

DatimePicker支持多种日期和时间模式的组合：

日期模式（DateMode）	时间模式（TimeMode）	描述
YEAR_MONTH_DAY	HOUR_24_NO_SECOND	年月日 + 时分
YEAR_MONTH_DAY	HOUR_24_HAS_SECOND	年月日 + 时分秒
YEAR_MONTH_DAY	HOUR_12_NO_SECOND	年月日 + 12小时制时分
YEAR_MONTH_DAY	HOUR_12_HAS_SECOND	年月日 + 12小时制时分秒
YEAR_MONTH	任意时间模式	年月 + 时间
MONTH_DAY	任意时间模式	月日 + 时间

配置示例：

// 设置日期模式为年月日
wheelLayout.setDateMode(DateMode.YEAR_MONTH_DAY);

// 设置时间模式为24小时制不带秒
wheelLayout.setTimeMode(TimeMode.HOUR_24_NO_SECOND);

3. 标签自定义

开发者可以自定义各个时间单位的显示标签：

// 设置日期标签
wheelLayout.setDateLabel("年", "月", "日");

// 设置时间标签  
wheelLayout.setTimeLabel("时", "分", "秒");

4. 格式化器配置

支持自定义日期和时间格式化显示：

// 设置日期格式化器
wheelLayout.setDateFormatter(new UnitDateFormatter());

// 设置时间格式化器
wheelLayout.setTimeFormatter(new UnitTimeFormatter());

联动机制实现

DatimePicker的核心优势在于其智能联动机制。当用户选择不同的日期时，时间选择器会自动调整可用的时间范围：

这种联动机制确保了用户选择的日期时间组合始终有效，避免了无效的时间选择。

事件监听处理

DatimePicker提供了丰富的事件监听接口：

// 设置日期时间选择监听器
picker.setOnDatimePickedListener(new OnDatimePickedListener() {
    @Override
    public void onDatimePicked(int year, int month, int day, 
                              int hour, int minute, int second) {
        String text = year + "-" + month + "-" + day + " " + 
                     hour + ":" + minute + ":" + second;
        Toast.makeText(getApplicationContext(), text, Toast.LENGTH_SHORT).show();
    }
});

// 设置选择过程中的实时监听
wheelLayout.setOnDatimeSelectedListener(new OnDatimeSelectedListener() {
    @Override
    public void onDatimeSelected(int year, int month, int day, 
                               int hour, int minute, int second) {
        // 实时处理选择变化
    }
});

高级配置选项

1. 联动重置控制

// 设置日期和时间联动时是否重置
wheelLayout.setResetWhenLinkage(true, false);
// 第一个参数：日期变化时时间是否重置
// 第二个参数：时间变化时日期是否重置

2. 时间步长设置

// 设置时间选择步长（小时步长、分钟步长、秒步长）
wheelLayout.setTimeStep(1, 5, 1);

3. 样式定制

// 启用选中项背景幕布
wheelLayout.setCurtainEnabled(true);
wheelLayout.setCurtainColor(0xFFCC0000);

// 启用指示器
wheelLayout.setIndicatorEnabled(true);
wheelLayout.setIndicatorColor(0xFFFF0000);

// 设置文字样式
wheelLayout.setTextColor(0xCCCC0000);
wheelLayout.setSelectedTextColor(0xFFFF0000);
wheelLayout.setTextSize(14);
wheelLayout.setSelectedTextSize(16);

实用工具方法

DatimeEntity提供了丰富的工具方法方便日期时间操作：

// 创建特定时间点的实体
DatimeEntity.target(2023, 12, 25, 14, 30, 0);

// 创建未来时间点的实体
DatimeEntity.minuteOnFuture(30);    // 30分钟后
DatimeEntity.hourOnFuture(2);       // 2小时后  
DatimeEntity.dayOnFuture(7);        // 7天后
DatimeEntity.monthOnFuture(1);      // 1个月后
DatimeEntity.yearOnFuture(1);       // 1年后

// 转换为时间戳
long timestamp = datimeEntity.toTimeInMillis();

性能优化策略

DatimePicker在性能方面做了多项优化：

1. 延迟加载：只有在控件可见时才初始化数据范围
2. 数据复用：日期和时间选择器共享基础滚轮组件
3. 事件代理：通过事件代理机制减少不必要的重绘
4. 内存管理：合理管理日期时间数据对象，避免内存泄漏

实际应用场景

DatimePicker适用于多种业务场景：

• 预约系统：医院挂号、会议室预订、服务预约
• 任务管理：设置任务开始和结束时间
• 日程安排：日历应用中的事件时间选择
• 订单系统：外卖配送时间、酒店入住时间选择
• 提醒设置：闹钟、提醒事项的时间设定

通过灵活的配置选项和强大的联动功能，DatimePicker能够满足各种复杂的日期时间选择需求，为Android应用提供专业级的日期时间选择解决方案。

日期时间格式化与范围限制的最佳实践

在Android应用开发中，日期时间选择器是极其常见的UI组件，而AndroidPicker库提供了强大且灵活的日期时间选择功能。本文将深入探讨如何通过最佳实践来实现日期时间的格式化显示和有效的范围限制，确保用户体验的流畅性和数据的准确性。

自定义日期时间格式化

AndroidPicker提供了灵活的格式化接口，允许开发者完全控制日期时间各部分的显示格式。通过实现DateFormatter和TimeFormatter接口，可以创建符合特定业务需求的格式化器。

基础格式化器实现

// 自定义日期格式化器
public class CustomDateFormatter implements DateFormatter {
    @Override
    public String formatYear(int year) {
        return String.format("%04d年", year);  // 四位年份显示
    }

    @Override
    public String formatMonth(int month) {
        String[] months = {"一月", "二月", "三月", "四月", "五月", "六月", 
                          "七月", "八月", "九月", "十月", "十一月", "十二月"};
        return months[month - 1];  // 中文月份显示
    }

    @Override
    public String formatDay(int day) {
        return String.format("%02d日", day);  // 两位日期显示
    }
}

// 自定义时间格式化器  
public class CustomTimeFormatter implements TimeFormatter {
    @Override
    public String formatHour(int hour) {
        return String.format("%02d时", hour);  // 24小时制
    }

    @Override
    public String formatMinute(int minute) {
        return String.format("%02d分", minute);
    }

    @Override
    public String formatSecond(int second) {
        return String.format("%02d秒", second);
    }
}

格式化器的应用配置

// 在日期选择器中应用自定义格式化器
DatePicker datePicker = new DatePicker(this);
DateWheelLayout dateWheelLayout = datePicker.getWheelLayout();
dateWheelLayout.setDateFormatter(new CustomDateFormatter());

// 在时间选择器中应用自定义格式化器
TimePicker timePicker = new TimePicker(this);
TimeWheelLayout timeWheelLayout = timePicker.getWheelLayout();
timeWheelLayout.setTimeFormatter(new CustomTimeFormatter());

智能范围限制策略

有效的范围限制是确保日期时间选择合理性的关键。AndroidPicker通过DateEntity和TimeEntity提供了强大的范围控制能力。

日期范围限制最佳实践

// 设置基本的日期范围
DateEntity startDate = DateEntity.target(2020, 1, 1);  // 开始日期
DateEntity endDate = DateEntity.target(2030, 12, 31);  // 结束日期
DateEntity defaultDate = DateEntity.today();  // 默认选中今天

dateWheelLayout.setRange(startDate, endDate, defaultDate);

// 动态范围设置示例：只能选择未来30天内的日期
DateEntity today = DateEntity.today();
DateEntity future30Days = DateEntity.dayOnFuture(30);
dateWheelLayout.setRange(today, future30Days, today);

// 业务场景：生日选择器（1900年至今）
DateEntity minBirthday = DateEntity.target(1900, 1, 1);
DateEntity maxBirthday = DateEntity.today();
dateWheelLayout.setRange(minBirthday, maxBirthday, DateEntity.target(1990, 1, 1));

时间范围限制最佳实践

// 设置24小时制时间范围
TimeEntity startTime = TimeEntity.target(0, 0, 0);    // 00:00:00
TimeEntity endTime = TimeEntity.target(23, 59, 59);   // 23:59:59
TimeEntity defaultTime = TimeEntity.target(9, 0, 0);  // 09:00:00

timeWheelLayout.setRange(startTime, endTime, defaultTime);

// 业务时间范围：营业时间 08:00-20:00
TimeEntity businessStart = TimeEntity.target(8, 0, 0);
TimeEntity businessEnd = TimeEntity.target(20, 0, 0);
timeWheelLayout.setRange(businessStart, businessEnd, businessStart);

// 时间步长设置：每15分钟一个间隔
timeWheelLayout.setTimeStep(1, 15, 1);  // 小时步长1，分钟步长15，秒步长1

联动选择与范围验证

AndroidPicker支持年月日之间的智能联动，确保选择的日期始终有效。

// 启用联动选择（默认开启）
dateWheelLayout.setResetWhenLinkage(true);

// 禁用联动选择（保持各轮独立）
dateWheelLayout.setResetWhenLinkage(false);

// 自定义联动逻辑示例
dateWheelLayout.setOnDateSelectedListener(new OnDateSelectedListener() {
    @Override
    public void onDateSelected(Integer year, Integer month, Integer day) {
        if (year != null && month != null) {
            // 动态计算该月的最大天数
            Calendar calendar = Calendar.getInstance();
            calendar.set(year, month - 1, 1);
            int maxDays = calendar.getActualMaximum(Calendar.DAY_OF_MONTH);
            
            // 如果当前选择的日期超过最大天数，自动调整
            if (day != null && day > maxDays) {
                dateWheelLayout.setDefaultValue(
                    DateEntity.target(year, month, maxDays)
                );
            }
        }
    }
});

多模式日期时间选择

AndroidPicker支持多种日期时间模式，可以根据业务需求灵活配置。

// 日期模式配置
dateWheelLayout.setDateMode(DateMode.YEAR_MONTH_DAY);  // 年月日
dateWheelLayout.setDateMode(DateMode.YEAR_MONTH);      // 年月
dateWheelLayout.setDateMode(DateMode.MONTH_DAY);       // 月日

// 时间模式配置
timeWheelLayout.setTimeMode(TimeMode.HOUR_24_NO_SECOND);   // 24小时制（无秒）
timeWheelLayout.setTimeMode(TimeMode.HOUR_24_HAS_SECOND);  // 24小时制（有秒）
timeWheelLayout.setTimeMode(TimeMode.HOUR_12_NO_SECOND);   // 12小时制（无秒）
timeWheelLayout.setTimeMode(TimeMode.HOUR_12_HAS_SECOND);  // 12小时制（有秒）

国际化与本地化支持

通过自定义格式化器，可以轻松实现日期时间的国际化显示。

// 英文日期格式化器
public class EnglishDateFormatter implements DateFormatter {
    @Override
    public String formatYear(int year) {
        return String.valueOf(year);
    }

    @Override
    public String formatMonth(int month) {
        String[] months = {"Jan", "Feb", "Mar", "Apr", "May", "Jun",
                          "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"};
        return months[month - 1];
    }

    @Override
    public String formatDay(int day) {
        return String.valueOf(day);
    }
}

// 12小时制时间格式化器
public class TwelveHourFormatter implements TimeFormatter {
    @Override
    public String formatHour(int hour) {
        if (hour == 0 || hour == 12) {
            return "12";
        }
        return String.valueOf(hour % 12);
    }

    @Override
    public String formatMinute(int minute) {
        return String.format("%02d", minute);
    }

    @Override
    public String formatSecond(int second) {
        return String.format("%02d", second);
    }
}

错误处理与边界情况

在实际应用中，需要妥善处理各种边界情况以确保稳定性。

// 范围验证
private void validateDateRange(DateEntity start, DateEntity end) {
    if (end.toTimeInMillis() < start.toTimeInMillis()) {
        throw new IllegalArgumentException("结束日期不能早于开始日期");
    }
    
    // 确保日期在合理范围内（1900-2100）
    if (start.getYear() < 1900 || end.getYear() > 2100) {
        throw new IllegalArgumentException("日期范围超出合理限制");
    }
}

// 安全设置范围
public void setSafeRange(DateEntity start, DateEntity end, DateEntity defaultValue) {
    try {
        validateDateRange(start, end);
        dateWheelLayout.setRange(start, end, defaultValue);
    } catch (IllegalArgumentException e) {
        // 自动调整为安全范围
        DateEntity safeStart = DateEntity.target(2000, 1, 1);
        DateEntity safeEnd = DateEntity.yearOnFuture(10);
        dateWheelLayout.setRange(safeStart, safeEnd, DateEntity.today());
        Toast.makeText(this, "自动调整到安全日期范围", Toast.LENGTH_SHORT).show();
    }
}

性能优化建议

对于需要频繁创建选择器的场景，可以采用对象池或缓存策略。

// 日期选择器对象池
private final Map<Integer, DatePicker> datePickerPool = new HashMap<>();

public DatePicker getDatePicker(int theme) {
    DatePicker picker = datePickerPool.get(theme);
    if (picker == null) {
        picker = new DatePicker(this, theme);
        // 预配置常用设置
        DateWheelLayout layout = picker.getWheelLayout();
        layout.setDateMode(DateMode.YEAR_MONTH_DAY);
        layout.setRange(DateEntity.today(), DateEntity.yearOnFuture(1));
        datePickerPool.put(theme, picker);
    }
    return picker;
}

// 清理不再使用的选择器
public void clearPool() {
    datePickerPool.clear();
}

通过上述最佳实践，开发者可以充分利用AndroidPicker的强大功能，创建出既美观又实用的日期时间选择器，同时确保数据的准确性和用户体验的流畅性。合理的格式化配置和范围限制不仅提升了应用的可用性，也大大减少了用户输入错误的可能性。

总结

AndroidPicker库为Android开发者提供了强大而灵活的日期时间选择解决方案。通过DatePicker、TimePicker和DatimePicker三大核心组件，开发者可以实现从简单的日期选择到复杂的日期时间联动选择等各种场景需求。本文详细介绍了各组件的配置选项、使用方法和最佳实践，包括日期时间格式化、范围限制、联动行为控制以及国际化支持等关键功能。合理的配置和使用这些组件不仅可以提升用户体验，还能确保数据的准确性和应用的稳定性。无论是基本的日期选择还是复杂的业务场景，AndroidPicker都能提供可靠的技术支持，是Android应用开发中日期时间选择功能的理想选择。

【免费下载链接】AndroidPicker 安卓选择器类库，包括日期及时间选择器（可用于出生日期、营业时间等）、单项选择器（可用于性别、民族、职业、学历、星座等）、二三级联动选择器（可用于车牌号、基金定投日期等）、城市地址选择器（分省级、地市级及区县级）、数字选择器（可用于年龄、身高、体重、温度等）、日历选日期择器（可用于酒店及机票预定日期）、颜色选择器、文件及目录选择器、图片选择器等……WheelPicker/DatePicker/TimePicker/OptionPicker/NumberPicker/LinkagePicker/AddressPicker/CarPlatePicker/CalendarPicker/ColorPicker/FilePicker/ImagePicker etc. 项目地址: https://gitcode.com/gh_mirrors/an/AndroidPicker