# HPickerView **Repository Path**: zzhhz/HPickerView ## Basic Information - **Project Name**: HPickerView - **Description**: Android日期选择器。 - **Primary Language**: Android - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2021-03-24 - **Last Updated**: 2025-03-25 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## Android-PickerView 原项目地址：https://github.com/Bigkoo/Android-PickerView.git 因为项目没有支持AndroidX，故fork一份放到gitee上，支持AndroidX ### 注意事项、详请使用方式、更新日志等，请查看 [Wiki文档](https://github.com/Bigkoo/Android-PickerView/wiki) **Wiki文档，Wiki文档，Wiki文档 !~ 重要的事情说三遍** #### 对于使用上有任何疑问或优化建议等，欢迎加入QQ群讨论交流技术问题。 交流群1： 387051294（推荐） 交流群2： 219962328（已满） ## 介绍 这是一款仿iOS的PickerView控件，有时间选择器和选项选择器，新版本的详细特性如下： ——TimePickerView 时间选择器，支持年月日时分，年月日，年月，时分等格式。 ——OptionsPickerView 选项选择器，支持一，二，三级选项选择，并且可以设置是否联动 。 * 支持三级联动 * 设置是否联动 * 设置循环模式 * 支持自定义布局。 * 支持item的分隔线设置。 * 支持item间距设置。 * 时间选择器支持起始和终止日期设定。 * 支持“年，月，日，时，分，秒”，“省，市，区”等选项的单位（label）显示、隐藏和自定义。 * 支持自定义文字、颜色、文字大小等属性 * Item的文字长度过长时，文字会自适应缩放到Item的长度，避免显示不完全的问题 * 支持Dialog 模式。 * 支持自定义设置容器。 * 实时回调。 ![TimePicker.gif](https://github.com/Bigkoo/Android-PickerView/blob/master/preview/timepicker.gif) ![TimePickerNight.gif](https://github.com/Bigkoo/Android-PickerView/blob/master/preview/timepicker_night.gif) ![lunar.gif](https://github.com/Bigkoo/Android-PickerView/blob/master/preview/lunar.gif) ![XOffset.png](https://github.com/Bigkoo/Android-PickerView/blob/master/preview/Screen%20Shot%202017-11-09%20at%204.25.02%20PM.png) ![Province.gif](https://github.com/Bigkoo/Android-PickerView/blob/master/preview/JsonData.gif) ![CustomLayout.gif](https://github.com/Bigkoo/Android-PickerView/blob/master/preview/CustomLayout.gif) ### 有兴趣研究3D滚轮效果的实现机制，希望把源码研究透彻的可以看看这篇博客： ### [Android-PickerView系列之源码解析篇（二）](http://blog.csdn.net/qq_22393017/article/details/59488906) ### 使用注意事项 * 注意：当我们进行设置时间的启始位置时，需要特别注意月份的设定 * 原因：Calendar组件内部的月份，是从0开始的，即0-11代表1-12月份 * 错误使用案例： startDate.set(2013,1,1);  endDate.set(2020,12,1); * 正确使用案例： startDate.set(2013,0,1);  endDate.set(2020,11,1); #### 更多历史版本详情，请查阅：[更新日志（4.x版本）](https://github.com/Bigkoo/Android-PickerView/wiki/更新日志（4.x版本）) #### 方法名与参数请查阅：[方法名与参数说明文档](https://github.com/Bigkoo/Android-PickerView/wiki/%E6%96%B9%E6%B3%95%E5%90%8D%E4%B8%8E%E5%8F%82%E6%95%B0%E8%AF%B4%E6%98%8E%EF%BC%883.x%E7%89%88%E6%9C%AC%EF%BC%89)
### **如何使用：** #### Android-PickerView 库使用示例： #### 1. Gradle依赖： ```java compile 'com.gitee:HPickerView:0.0.1' ``` #### 2.在项目中添加如下代码： ```java //时间选择器 TimePickerView pvTime = new TimePickerBuilder(MainActivity.this, new OnTimeSelectListener() { @Override public void onTimeSelect(Date date, View v) { Toast.makeText(MainActivity.this, getTime(date), Toast.LENGTH_SHORT).show(); } }).build(); ``` ```java //条件选择器 OptionsPickerView pvOptions = new OptionsPickerBuilder(MainActivity.this, new OnOptionsSelectListener() { @Override public void onOptionsSelect(int options1, int option2, int options3 ,View v) { //返回的分别是三个级别的选中位置 String tx = options1Items.get(options1).getPickerViewText() + options2Items.get(options1).get(option2) + options3Items.get(options1).get(option2).get(options3).getPickerViewText(); tvOptions.setText(tx); } }).build(); pvOptions.setPicker(options1Items, options2Items, options3Items); pvOptions.show(); ``` #### 大功告成~ #### 3.如果默认样式不符合你的口味，可以自定义各种属性： ```java Calendar selectedDate = Calendar.getInstance(); Calendar startDate = Calendar.getInstance(); //startDate.set(2013,1,1); Calendar endDate = Calendar.getInstance(); //endDate.set(2020,1,1); //正确设置方式 原因：注意事项有说明  startDate.set(2013,0,1);  endDate.set(2020,11,31); pvTime = new TimePickerBuilder(this, new OnTimeSelectListener() { @Override public void onTimeSelect(Date date,View v) {//选中事件回调 tvTime.setText(getTime(date)); } }) .setType(new boolean[]{true, true, true, true, true, true})// 默认全部显示 .setCancelText("Cancel")//取消按钮文字 .setSubmitText("Sure")//确认按钮文字 .setContentSize(18)//滚轮文字大小 .setTitleSize(20)//标题文字大小 .setTitleText("Title")//标题文字 .setOutSideCancelable(false)//点击屏幕，点在控件外部范围时，是否取消显示 .isCyclic(true)//是否循环滚动 .setTitleColor(Color.BLACK)//标题文字颜色 .setSubmitColor(Color.BLUE)//确定按钮文字颜色 .setCancelColor(Color.BLUE)//取消按钮文字颜色 .setTitleBgColor(0xFF666666)//标题背景颜色 Night mode .setBgColor(0xFF333333)//滚轮背景颜色 Night mode .setDate(selectedDate)// 如果不设置的话，默认是系统时间*/ .setRangDate(startDate,endDate)//起始终止年月日设定 .setLabel("年","月","日","时","分","秒")//默认设置为年月日时分秒 .isCenterLabel(false) //是否只显示中间选中项的label文字，false则每项item全部都带有label。 .isDialog(true)//是否显示为对话框样式 .build(); ``` ```java pvOptions = new OptionsPickerBuilder(this, new OptionsPickerView.OnOptionsSelectListener() { @Override public void onOptionsSelect(int options1, int option2, int options3 ,View v) { //返回的分别是三个级别的选中位置 String tx = options1Items.get(options1).getPickerViewText() + options2Items.get(options1).get(option2) + options3Items.get(options1).get(option2).get(options3).getPickerViewText(); tvOptions.setText(tx); } }) .setOptionsSelectChangeListener(new OnOptionsSelectChangeListener() { @Override public void onOptionsSelectChanged(int options1, int options2, int options3) { String str = "options1: " + options1 + "\noptions2: " + options2 + "\noptions3: " + options3; Toast.makeText(MainActivity.this, str, Toast.LENGTH_SHORT).show(); } }) .setSubmitText("确定")//确定按钮文字 .setCancelText("取消")//取消按钮文字 .setTitleText("城市选择")//标题 .setSubCalSize(18)//确定和取消文字大小 .setTitleSize(20)//标题文字大小 .setTitleColor(Color.BLACK)//标题文字颜色 .setSubmitColor(Color.BLUE)//确定按钮文字颜色 .setCancelColor(Color.BLUE)//取消按钮文字颜色 .setTitleBgColor(0xFF333333)//标题背景颜色 Night mode .setBgColor(0xFF000000)//滚轮背景颜色 Night mode .setContentTextSize(18)//滚轮文字大小 .setLinkage(false)//设置是否联动，默认true .setLabels("省", "市", "区")//设置选择的三级单位 .isCenterLabel(false) //是否只显示中间选中项的label文字，false则每项item全部都带有label。 .setCyclic(false, false, false)//循环与否 .setSelectOptions(1, 1, 1) //设置默认选中项 .setOutSideCancelable(false)//点击外部dismiss default true .isDialog(true)//是否显示为对话框样式 .isRestoreItem(true)//切换时是否还原，设置默认选中第一项。 .build(); pvOptions.setPicker(options1Items, options2Items, options3Items);//添加数据源 ``` #### 4.如果需要自定义布局： ```java // 注意：自定义布局中，id为 optionspicker 或者 timepicker 的布局以及其子控件必须要有，否则会报空指针 // 具体可参考demo 里面的两个自定义布局 pvCustomOptions = new OptionsPickerBuilder(this, new OptionsPickerView.OnOptionsSelectListener() { @Override public void onOptionsSelect(int options1, int option2, int options3, View v) { //返回的分别是三个级别的选中位置 String tx = cardItem.get(options1).getPickerViewText(); btn_CustomOptions.setText(tx); } }) .setLayoutRes(R.layout.pickerview_custom_options, new CustomListener() { @Override public void customLayout(View v) { //自定义布局中的控件初始化及事件处理 final TextView tvSubmit = (TextView) v.findViewById(R.id.tv_finish); final TextView tvAdd = (TextView) v.findViewById(R.id.tv_add); ImageView ivCancel = (ImageView) v.findViewById(R.id.iv_cancel); tvSubmit.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { pvCustomOptions.returnData(tvSubmit); } }); ivCancel.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { pvCustomOptions.dismiss(); } }); tvAdd.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { getData(); pvCustomOptions.setPicker(cardItem); } }); } }) .build(); pvCustomOptions.setPicker(cardItem);//添加数据 ``` #### 5.对使用还有疑问的话，可参考demo代码 [请戳我查看demo代码](https://github.com/Bigkoo/Android-PickerView/blob/master/app/src/main/java/com/bigkoo/pickerviewdemo/MainActivity.java) #### 6.若只需要WheelView基础控件自行扩展实现逻辑，可直接添加基础控件库，Gradle 依赖： ```java compile 'com.contrarywind:wheelview:4.1.0' ``` #### WheelView 使用代码示例： xml布局： ```xml ``` Java 代码： ```java WheelView wheelView = findViewById(R.id.wheelview); wheelView.setCyclic(false); final List mOptionsItems = new ArrayList<>(); mOptionsItems.add("item0"); mOptionsItems.add("item1"); mOptionsItems.add("item2"); wheelView.setAdapter(new ArrayWheelAdapter(mOptionsItems)); wheelView.setOnItemSelectedListener(new OnItemSelectedListener() { @Override public void onItemSelected(int index) { Toast.makeText(MainActivity.this, "" + mOptionsItems.get(index), Toast.LENGTH_SHORT).show(); } }); ``` ### 效果图（招行信用卡的“掌上生活”里面条件选择器他们用的就是我这个库，大家可以当实际项目参考） ![](https://github.com/saiwu-bigkoo/Android-PickerView/blob/master/preview/pickerdemo_zhangshangshenghuo.gif) ### Thanks - WheelView - [androidWheelView](https://github.com/weidongjian/androidWheelView/)