企业官网建设流程全解析

Android 时间选择器快速定制指南：用 Android-PickerView 从 0 到 1 调教年月日时分秒

【免费下载链接】Android-PickerViewThis is a picker view for android , support linkage effect, timepicker and optionspicker.（时间选择器、省市区三级联动）项目地址: https://gitcode.com/gh_mirrors/an/Android-PickerView

预约挂号、酒店订房、外卖送餐——凡是和"时间"打交道的界面，都绕不开一个老问题：系统自带的 Android 时间选择器，能不能按自己的需求控制年月日时分秒？单选一个日期还好办，可一旦要隐藏"秒"、替换单位文案、限制可选范围、统一品牌色，原生控件就有点力不从心了。

系统DatePicker做不到的事，交给开源滚轮选择器就好。Android-PickerView 就是干这个的：它同时提供时间选择与省市区联动能力，社区里用的人多，API 走的是链式调用，配起来很像"搭积木"。一句话总结：想把年月日时分秒的显示格式捏成自己想要的样子，核心就是配置一个TimePickerBuilder，剩下的滚轮、联动、弹层逻辑它全包了。

本文就从一个真实的"预约时间"场景出发，带你走一遍需求拆解 → API 选型 → 逐步实现 → 避坑收尾的完整链路。读完你就能在自己的项目里复刻一套。

动手前，先拆需求

假设你接到这样一个需求：预约页面里，用户只能选"今天起 30 天内"的日期，时间只精确到分钟，单位文案要显示"小时 / 分钟"，配色要和 App 主色一致。

别急着写代码，先把需求拆成 4 个可落地的小问题：

1. 显示哪些单位？秒要藏起来，年、月、日、时、分都要。
2. 单位文案叫什么？默认可能是"年 月 日 时 分 秒"，得能换。
3. 范围怎么圈？只能选今天到 30 天后的区间。
4. 长什么样？分割线颜色、选中项颜色、行间距都要可调。

每个问题都能在 Android-PickerView 里找到对应的配置项，下面逐个击破。

选对入口：为什么是 TimePickerBuilder

项目分三个模块，各司其职：

• wheelview/：滚轮控件本身，最底层的轮子；
• pickerview/：封装好的选择器，时间选择、选项选择都在这；
• app/：官方 demo，几乎每种玩法都有现成例子。

时间选择器的构建入口是TimePickerBuilder，它采用链式调用：一个方法干一件事，返回的还是它自己，最后用build()产出TimePickerView。这种写法可读性强，参数多也不容易乱。

TimePickerView pvTime = new TimePickerBuilder(this, new OnTimeSelectListener() { @Override public void onTimeSelect(Date date, View v) { btnTime.setText(fmt.format(date)); // 选中后回填到按钮 } }) // ...... 中间全是配置项，往下看 .build();

build()之后别忘了pvTime.show(v)，选择器才会弹出来。回调用第二个参数v能定位到触发它的控件，多入口共用一个选择器时很好用。

需求一：如何隐藏不需要的时间单位

控制单位显隐的方法叫setType，它接收一个长度固定为 6 的布尔数组，顺序依次是：年、月、日、时、分、秒。哪个位置填true，哪个单位就显示。

回到预约场景，秒必须藏，于是这样写：

// 顺序：年、月、日、时、分、秒 // 前 5 个 true，最后 1 个 false，把“秒”关掉 .setType(new boolean[]{true, true, true, true, true, false})

如果你连年月日都不需要，只留时分秒，把前三位改成false即可。数组顺序千万不能记错——把"秒"的位置放错，界面上就会出现一个不是你想要的时间列。

需求二：3 步配置自定义时间单位文案

默认的单位文字是"年 月 日 时 分 秒"，用setLabel可以整体替换。它接收 6 个字符串参数，顺序同样对应年、月、日、时、分、秒。

// 参数顺序：年、月、日、时、分、秒 .setLabel("年", "月", "日", "小时", "分钟", "")

这里有两个小技巧：

1. 想彻底不显示单位文字，对应位置传空字符串""就行；
2. 想换成字母，比如setLabel("Y", "M", "D", "h", "m", "s")，英文风格一秒达成。

再配合isCenterLabel(false)决定单位文字是"每行都带"还是"只在中间选中行显示"。默认是每个 item 都带 label，如果你觉得滚动时满屏都是单位太吵，把它设为true只留中间一行，视觉上会清爽很多。

需求三：如何限定可选时间范围

范围控制由两个方法搭档完成：

• setDate(Calendar)：设定默认选中的时间；
• setRangDate(Calendar start, Calendar end)：圈定可选的起止区间。

Calendar selected = Calendar.getInstance(); // 默认选中当前时刻 Calendar start = Calendar.getInstance(); start.set(2024, 0, 1); // 2024 年 1 月 1 日 Calendar end = Calendar.getInstance(); end.set(2026, 11, 31); // 2026 年 12 月 31 日 .setDate(selected) // 默认选中值 .setRangDate(start, end) // 可选范围

注意一个容易忽视的细节：不调setRangDate时，默认范围是 1900 年到 2100 年，对绝大多数业务来说太宽了，建议每次都显式圈一下。另外动态范围也很好做——start直接取Calendar.getInstance()，end在它基础上add(Calendar.DAY_OF_MONTH, 30)，就是"今天起 30 天内"。

需求四：自定义时间选择器的外观样式

外观相关的配置集中在颜色、字号、间距三类，组合起来就能贴合品牌色。

.setContentTextSize(18) // 滚轮文字大小，默认 18 .setLineSpacingMultiplier(2.0f) // 条目行距倍数，范围 1.0f ~ 4.0f .setDividerColor(0xFF24AD9D) // 上下分割线颜色 .setTextColorCenter(0xFF24AD9D) // 中间选中项文字颜色 .setTextColorOut(0xFFa8a8a8) // 分割线以外文字颜色

几个容易出效果的补充项：

• setTextXOffset(年, 月, 日, 时, 分, 秒)：给每个滚轮单独做 X 轴偏移，单位是 px，可传负值。demo 里给"时""分"传了40, 0, -40，用于对齐视觉中心；
• setItemVisibleCount(5)：控制一屏可见条目数，建议取 3、5、7、9 这类奇数，传偶数会被自动 +1；
• isAlphaGradient(true)：滚轮上下两端做透明度渐变，观感更柔和。

如果你连顶栏、按钮都想换掉，直接上setLayoutRes自定义布局，这块放后面讲。

常见坑与避坑指南

配置项多，坑也多。以下几条是实操中翻车率最高的，提前打好预防针：

1. Calendar 的月份从 0 开始计。start.set(2024, 1, 23)其实是2 月 23 日，不是 1 月。想表示 1 月就写 0，这个坑在setDate和setRangDate里都会遇到，极易造成"范围少一个月"的诡异 bug。
2. setType 数组长度必须恰好是 6。少一位直接数组越界崩溃，多一位也会出问题。建议在代码里用注释标好"年、月、日、时、分、秒"六个字。
3. setItemVisibleCount 传偶数会悄悄 +1。想要 6 个可见项？实际显示 7 个，别和设计稿较劲。
4. setLineSpacingMultiplier 只能在 1.0f ~ 4.0f 之间。超出范围可能得到不可预期的间距。
5. 自定义布局必须保留 id 为timepicker的容器。Android-PickerView 靠这个 id 找到滚轮区域，删了必空指针。可以拿pickerview_custom_time.xml当模板改，别从零手写。
6. 自定义布局里点"确定"要手动触发回调。常规写法是pvCustomTime.returnData()再pvCustomTime.dismiss()，只dismiss()的话onTimeSelect永远不会执行，回填自然不生效。

高频参数速查表

再进一步：还能玩出什么花样

到这里，年月日时分秒的定制已经全覆盖了。如果你想继续深入，仓库里的 demo 就是最好的教材：

• 在app模块的MainActivity里，initTimePicker()展示了底部 Dialog 弹窗模式，initCustomTimePicker()是本文场景的完整版，initLunarPicker()演示了农历日历的接入方式；
• 想彻底改头换面，试试setLayoutRes搭配自定义布局模板，把顶栏、按钮、配色全部换成自己的设计；
• 需要滚动即反馈的联动效果（比如选中日期后实时刷新价格），用setTimeSelectChangeListener拿滚动中的实时值。

下一步你可以尝试：给手头的预约/订房场景加一套农历支持，或者把选择器封装成一个通用组件，把setType、setLabel、setRangDate暴露成方法参数，让产品和设计改需求时，你只改一行调用就能交付。祝你的时间选择器既好看又顺手。🎯

【免费下载链接】Android-PickerViewThis is a picker view for android , support linkage effect, timepicker and optionspicker.（时间选择器、省市区三级联动）项目地址: https://gitcode.com/gh_mirrors/an/Android-PickerView