Android 时间选择器自定义终极指南用 PickerView 三分钟搞定年月日时分秒格式【免费下载链接】Android-PickerViewThis is a picker view for android , support linkage effect, timepicker and optionspicker.时间选择器、省市区三级联动项目地址: https://gitcode.com/gh_mirrors/an/Android-PickerView做 Android 开发的朋友大概率都遇到过这样的场景App 要选生日、选预约时间、选发货日期系统自带的 DatePicker 界面老旧、样式固定改起来又麻烦。而 Android-PickerView 这个开源的时间选择器与选项选择器组件凭借仿 iOS 的滚轮效果和几乎全开放的自定义能力成了很多人手边的时间选择器自定义首选方案。这篇文章不堆 API 文档而是站在我要做出什么样的角度帮你快速搞定年月日时分秒的各种玩法。一、先搞清楚你到底需要哪种时间选择器核心结论选错构建类后面全是白忙活。Android-PickerView 里有两个核心入口别看名字像用途完全两回事TimePickerBuilder专门做时间选择年、月、日、时、分、秒六个滚轮任意组合OptionsPickerBuilder专门做选项选择比如省市区三级联动、品牌型号这类文字列表。如果你的需求是选一个时间点直奔TimePickerBuilder就对了。它的使用方式很像搭积木new 一个 Builder把你要的积木显示哪些单位、范围多大、什么颜色一块块拼上去最后.build()一下一个可用的选择器就诞生了。二、三步快速上手从零跑通一个日期选择器核心结论记住新建 → 配置 → 弹窗三步五分钟内看到效果。第一步写好回调。所有时间选择器都离不开一个选完时间后干什么的回调通常在onTimeSelect里拿到一个Date对象格式化后填到你的按钮或输入框上new TimePickerBuilder(this, (date, v) - btn.setText(format(date)))第二步决定滚轮上出现哪些单位。这是整个组件最核心的配置一个长度为 6 的布尔数组依次对应年、月、日、时、分、秒true 显示、false 隐藏.setType(new boolean[]{true, true, true, false, false, false})上面这行就是只要年月日。同理把后三位全设成 true 就是只要时分秒。第三步弹出来。调.build()得到选择器对象后在按钮点击事件里调用它的show()方法即可。看到滚轮转起来的那一刻你就已经掌握它 80% 的用法了。三、高频需求速查表按业务场景直接抄作业核心结论99% 的定制需求都逃不出下面这几张配方对号入座即可。场景 1只让用户选时间点预约、打卡、提醒把年月日全部隐藏只留时分秒再配上中文标签就是一个清爽的时刻选择器.setType(new boolean[]{false, false, false, true, true, true}) .setLabel(年, 月, 日, 时, 分, 秒)场景 2限制可选范围生日不能选未来活动截止有期限用setRangDate传入起止Calendar即可。组件会自动处理边界默认选中日期如果超出范围会静默回退到起始日期不会让你选出一个非法值.setRangDate(startDate, endDate)场景 3界面风格跟 App 不搭换色、换字号滚轮上的文字大小、分割线颜色、选中项颜色、甚至分割线样式都能单独设置连深色模式都能靠这几招拼出来.setContentTextSize(18) .setDividerColor(0xFF24AD9D) .setTextColorCenter(0xFF24AD9D)场景 4要农历传统节日、生辰八字类应用一行开关切到农历模式组件会基于内置的 1900–2100 年农历数据做公农历换算选定后回调里拿到的仍是公历时间方便你继续存储和运算.setLunarCalendar(true)场景 5连布局都想重画去掉系统标题栏、加自己的按钮setLayoutRes允许你丢进一个完全自定义的 XML 布局再通过CustomListener回调拿到布局里的控件自己接管确定/取消逻辑。项目里自带的时间选择器自定义布局示例就在app/src/main/res/layout/pickerview_custom_time.xml直接抄过来改最快。四、避坑指南新手最容易踩的五个坑核心结论这五个坑占到了社区求助帖的八成提前看完能省一整天。以下是几个常见报错与解决思路现象原因解决思路时间范围错乱起始比终止还早Calendar的月份从 0 开始计数0 代表 1 月月份记得减 1比如 12 月要写成 11抛type[] length is not 6setType传的数组长度不是 6数组固定写满 6 个布尔值自定义布局后闪退、空指针布局里必须保留 id 为timepicker或optionspicker的容器及其内部滚轮控件参考 demo 里的自定义布局删减或改 id 都会导致初始化找不到内容选中日期莫名跑到范围边缘setDate设定的默认值越界组件自动回退先定范围再保证默认日期在范围内范围设反了抛IllegalArgumentException起始时间晚于终止时间检查两次set的顺序与月份五、进阶玩法让你的选择器更懂人核心结论基础配置只是及格线下面这几招才是体验升级的关键。实时回调用setTimeSelectChangeListener可以在滚轮每停一次就收到一次回调适合做选年份立刻联动显示别的信息这种交互不用等用户点确定。滚轮手感setLineSpacingMultiplier控制每行间距建议 1.0–4.0 之间isCyclic决定滚轮能不能循环转圈setItemVisibleCount控制可见条目数偶数会自动加一保证居中效果。细粒度微调setTextXOffset可以单独把某个滚轮的横向偏移一点解决单位标签拥挤的问题isCenterLabel(false)则让每个 item 都带单位而不是只有选中行带视觉效果差异很大。做成 Dialog 模式开启isDialog(true)后再配合getDialog()调整窗口的对齐方式比如固定在底部和入场动画就能得到接近系统弹窗的体验。六、常见问题FAQ问我只想选年和月怎么办答setType数组写成{true, true, false, false, false, false}滚轮上就只剩年月两个轮子。问回调里拿到的 Date 要怎么转成2026-08-17 14:30这种格式答回调参数就是标准的java.util.Date用SimpleDateFormat按自己需要的格式格式化即可demo 里也提供了getTime这样的现成方法参考。问项目还没集成这个库怎么开始答可以直接用git clone https://gitcode.com/gh_mirrors/an/Android-PickerView把源码拉下来把pickerview和wheelview两个模块以源码方式引入自己的工程demo 里的app模块就是最好的学习样板。问为什么我设了 2100 年之后的日期范围没生效答组件的农历与默认时间范围都限定在 1900–2100 年超出这个区间属于支持的边界之外建议尽量把业务日期圈定在这个范围内。写在最后Android-PickerView 的价值在于它把滚轮式选择这种强交互封装成了人人可用的积木时间选择器自定义不再是设计师和高端玩家的专属。拿到这篇文章建议你先跑通第二节的三步流程再对照第三节的速查表找到自己的场景最后把避坑指南收藏起来备用。延伸阅读想深入理解滚轮滚动、惯性、吸附这些底层机制的实现可以阅读项目源码中的WheelView与WheelTime两个核心类想研究省市区三级联动直接看app/src/main/java/com/bigkoo/pickerviewdemo/JsonDataActivity.java和 assets 目录下的省份 JSON 数据下一个惊艳的产品交互就从这里开始。【免费下载链接】Android-PickerViewThis is a picker view for android , support linkage effect, timepicker and optionspicker.时间选择器、省市区三级联动项目地址: https://gitcode.com/gh_mirrors/an/Android-PickerView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Android 时间选择器自定义终极指南：用 PickerView 三分钟搞定年月日时分秒格式
Android 时间选择器自定义终极指南用 PickerView 三分钟搞定年月日时分秒格式【免费下载链接】Android-PickerViewThis is a picker view for android , support linkage effect, timepicker and optionspicker.时间选择器、省市区三级联动项目地址: https://gitcode.com/gh_mirrors/an/Android-PickerView做 Android 开发的朋友大概率都遇到过这样的场景App 要选生日、选预约时间、选发货日期系统自带的 DatePicker 界面老旧、样式固定改起来又麻烦。而 Android-PickerView 这个开源的时间选择器与选项选择器组件凭借仿 iOS 的滚轮效果和几乎全开放的自定义能力成了很多人手边的时间选择器自定义首选方案。这篇文章不堆 API 文档而是站在我要做出什么样的角度帮你快速搞定年月日时分秒的各种玩法。一、先搞清楚你到底需要哪种时间选择器核心结论选错构建类后面全是白忙活。Android-PickerView 里有两个核心入口别看名字像用途完全两回事TimePickerBuilder专门做时间选择年、月、日、时、分、秒六个滚轮任意组合OptionsPickerBuilder专门做选项选择比如省市区三级联动、品牌型号这类文字列表。如果你的需求是选一个时间点直奔TimePickerBuilder就对了。它的使用方式很像搭积木new 一个 Builder把你要的积木显示哪些单位、范围多大、什么颜色一块块拼上去最后.build()一下一个可用的选择器就诞生了。二、三步快速上手从零跑通一个日期选择器核心结论记住新建 → 配置 → 弹窗三步五分钟内看到效果。第一步写好回调。所有时间选择器都离不开一个选完时间后干什么的回调通常在onTimeSelect里拿到一个Date对象格式化后填到你的按钮或输入框上new TimePickerBuilder(this, (date, v) - btn.setText(format(date)))第二步决定滚轮上出现哪些单位。这是整个组件最核心的配置一个长度为 6 的布尔数组依次对应年、月、日、时、分、秒true 显示、false 隐藏.setType(new boolean[]{true, true, true, false, false, false})上面这行就是只要年月日。同理把后三位全设成 true 就是只要时分秒。第三步弹出来。调.build()得到选择器对象后在按钮点击事件里调用它的show()方法即可。看到滚轮转起来的那一刻你就已经掌握它 80% 的用法了。三、高频需求速查表按业务场景直接抄作业核心结论99% 的定制需求都逃不出下面这几张配方对号入座即可。场景 1只让用户选时间点预约、打卡、提醒把年月日全部隐藏只留时分秒再配上中文标签就是一个清爽的时刻选择器.setType(new boolean[]{false, false, false, true, true, true}) .setLabel(年, 月, 日, 时, 分, 秒)场景 2限制可选范围生日不能选未来活动截止有期限用setRangDate传入起止Calendar即可。组件会自动处理边界默认选中日期如果超出范围会静默回退到起始日期不会让你选出一个非法值.setRangDate(startDate, endDate)场景 3界面风格跟 App 不搭换色、换字号滚轮上的文字大小、分割线颜色、选中项颜色、甚至分割线样式都能单独设置连深色模式都能靠这几招拼出来.setContentTextSize(18) .setDividerColor(0xFF24AD9D) .setTextColorCenter(0xFF24AD9D)场景 4要农历传统节日、生辰八字类应用一行开关切到农历模式组件会基于内置的 1900–2100 年农历数据做公农历换算选定后回调里拿到的仍是公历时间方便你继续存储和运算.setLunarCalendar(true)场景 5连布局都想重画去掉系统标题栏、加自己的按钮setLayoutRes允许你丢进一个完全自定义的 XML 布局再通过CustomListener回调拿到布局里的控件自己接管确定/取消逻辑。项目里自带的时间选择器自定义布局示例就在app/src/main/res/layout/pickerview_custom_time.xml直接抄过来改最快。四、避坑指南新手最容易踩的五个坑核心结论这五个坑占到了社区求助帖的八成提前看完能省一整天。以下是几个常见报错与解决思路现象原因解决思路时间范围错乱起始比终止还早Calendar的月份从 0 开始计数0 代表 1 月月份记得减 1比如 12 月要写成 11抛type[] length is not 6setType传的数组长度不是 6数组固定写满 6 个布尔值自定义布局后闪退、空指针布局里必须保留 id 为timepicker或optionspicker的容器及其内部滚轮控件参考 demo 里的自定义布局删减或改 id 都会导致初始化找不到内容选中日期莫名跑到范围边缘setDate设定的默认值越界组件自动回退先定范围再保证默认日期在范围内范围设反了抛IllegalArgumentException起始时间晚于终止时间检查两次set的顺序与月份五、进阶玩法让你的选择器更懂人核心结论基础配置只是及格线下面这几招才是体验升级的关键。实时回调用setTimeSelectChangeListener可以在滚轮每停一次就收到一次回调适合做选年份立刻联动显示别的信息这种交互不用等用户点确定。滚轮手感setLineSpacingMultiplier控制每行间距建议 1.0–4.0 之间isCyclic决定滚轮能不能循环转圈setItemVisibleCount控制可见条目数偶数会自动加一保证居中效果。细粒度微调setTextXOffset可以单独把某个滚轮的横向偏移一点解决单位标签拥挤的问题isCenterLabel(false)则让每个 item 都带单位而不是只有选中行带视觉效果差异很大。做成 Dialog 模式开启isDialog(true)后再配合getDialog()调整窗口的对齐方式比如固定在底部和入场动画就能得到接近系统弹窗的体验。六、常见问题FAQ问我只想选年和月怎么办答setType数组写成{true, true, false, false, false, false}滚轮上就只剩年月两个轮子。问回调里拿到的 Date 要怎么转成2026-08-17 14:30这种格式答回调参数就是标准的java.util.Date用SimpleDateFormat按自己需要的格式格式化即可demo 里也提供了getTime这样的现成方法参考。问项目还没集成这个库怎么开始答可以直接用git clone https://gitcode.com/gh_mirrors/an/Android-PickerView把源码拉下来把pickerview和wheelview两个模块以源码方式引入自己的工程demo 里的app模块就是最好的学习样板。问为什么我设了 2100 年之后的日期范围没生效答组件的农历与默认时间范围都限定在 1900–2100 年超出这个区间属于支持的边界之外建议尽量把业务日期圈定在这个范围内。写在最后Android-PickerView 的价值在于它把滚轮式选择这种强交互封装成了人人可用的积木时间选择器自定义不再是设计师和高端玩家的专属。拿到这篇文章建议你先跑通第二节的三步流程再对照第三节的速查表找到自己的场景最后把避坑指南收藏起来备用。延伸阅读想深入理解滚轮滚动、惯性、吸附这些底层机制的实现可以阅读项目源码中的WheelView与WheelTime两个核心类想研究省市区三级联动直接看app/src/main/java/com/bigkoo/pickerviewdemo/JsonDataActivity.java和 assets 目录下的省份 JSON 数据下一个惊艳的产品交互就从这里开始。【免费下载链接】Android-PickerViewThis is a picker view for android , support linkage effect, timepicker and optionspicker.时间选择器、省市区三级联动项目地址: https://gitcode.com/gh_mirrors/an/Android-PickerView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考