Android-PickerView 时间选择器实战:自定义年月日时分秒格式
【免费下载链接】Android-PickerView 项目地址: https://gitcode.com/gh_mirrors/and/Android-PickerView
在Android应用开发中,时间选择器是用户交互的重要组件。你是否还在为系统自带时间选择器样式单一、格式固定而烦恼?Android-PickerView提供了灵活的自定义能力,让你轻松实现各种时间格式需求。读完本文,你将掌握如何自定义年月日时分秒的显示格式,包括隐藏特定时间单位、修改标签文字、调整布局样式等实用技巧。
时间选择器核心构建类
时间选择器的自定义主要通过TimePickerBuilder类实现,位于pickerview/src/main/java/com/bigkoo/pickerview/builder/TimePickerBuilder.java。该类提供了丰富的配置方法,允许开发者控制时间选择器的各种属性。
关键配置方法
setType(boolean[] type):控制年月日时分秒的显示或隐藏,布尔数组长度必须为6,分别对应"年"、"月"、"日"、"时"、"分"、"秒"setLabel(String label_year, String label_month, String label_day, String label_hours, String label_mins, String label_seconds):设置各时间单位的标签文字setDate(Calendar date):设置默认选中日期setRangDate(Calendar startDate, Calendar endDate):设置时间选择范围setLayoutRes(int res, CustomListener customListener):自定义布局文件
基础时间格式自定义
1. 显示/隐藏时间单位
通过setType方法可以灵活控制需要显示的时间单位。例如,只显示时分秒:
// 只显示时分秒
boolean[] type = {false, false, false, true, true, true};
pvCustomTime = new TimePickerBuilder(this, new OnTimeSelectListener() {
@Override
public void onTimeSelect(Date date, View v) {
btn_CustomTime.setText(getTime(date));
}
})
.setType(type) // 设置显示类型
.build();
2. 自定义时间单位标签
使用setLabel方法可以修改默认的时间单位标签,例如将"年"改为"Y","月"改为"M":
pvCustomTime = new TimePickerBuilder(this, new OnTimeSelectListener() {
// ...
})
.setLabel("Y", "M", "D", "h", "m", "s") // 自定义标签
.build();
3. 调整时间选择范围
通过setRangDate方法可以限制可选的时间范围,例如只允许选择2014-2027年之间的日期:
Calendar startDate = Calendar.getInstance();
startDate.set(2014, 1, 23);
Calendar endDate = Calendar.getInstance();
endDate.set(2027, 2, 28);
pvCustomTime = new TimePickerBuilder(this, new OnTimeSelectListener() {
// ...
})
.setRangDate(startDate, endDate) // 设置时间范围
.build();
高级布局样式自定义
1. 使用自定义布局文件
Android-PickerView支持通过setLayoutRes方法加载自定义布局,实现更复杂的UI效果。例如,自定义的时间选择器布局文件app/src/main/res/layout/pickerview_custom_time.xml:
pvCustomTime = new TimePickerBuilder(this, new OnTimeSelectListener() {
@Override
public void onTimeSelect(Date date, View v) {
btn_CustomTime.setText(getTime(date));
}
})
.setLayoutRes(R.layout.pickerview_custom_time, new CustomListener() {
@Override
public void customLayout(View v) {
// 自定义布局中的控件操作
final TextView tvSubmit = (TextView) v.findViewById(R.id.tv_finish);
ImageView ivCancel = (ImageView) v.findViewById(R.id.iv_cancel);
// ...
}
})
.build();
2. 调整文字大小和颜色
可以通过相关方法调整选择器中的文字大小、颜色等样式:
pvCustomTime = new TimePickerBuilder(this, new OnTimeSelectListener() {
// ...
})
.setContentTextSize(18) // 滚轮文字大小
.setDividerColor(0xFF24AD9D) // 分割线颜色
.setTextColorCenter(0xFF24AD9D) // 选中项文字颜色
.build();
完整示例:自定义时分秒选择器
下面是一个完整的自定义时分秒选择器示例,位于app/src/main/java/com/bigkoo/pickerviewdemo/MainActivity.java:
private void initCustomTimePicker() {
Calendar selectedDate = Calendar.getInstance();
Calendar startDate = Calendar.getInstance();
startDate.set(2014, 1, 23);
Calendar endDate = Calendar.getInstance();
endDate.set(2027, 2, 28);
pvCustomTime = new TimePickerBuilder(this, new OnTimeSelectListener() {
@Override
public void onTimeSelect(Date date, View v) {
btn_CustomTime.setText(getTime(date));
}
})
.setDate(selectedDate)
.setRangDate(startDate, endDate)
.setLayoutRes(R.layout.pickerview_custom_time, new CustomListener() {
@Override
public void customLayout(View v) {
final TextView tvSubmit = (TextView) v.findViewById(R.id.tv_finish);
ImageView ivCancel = (ImageView) v.findViewById(R.id.iv_cancel);
tvSubmit.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
pvCustomTime.returnData();
pvCustomTime.dismiss();
}
});
ivCancel.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
pvCustomTime.dismiss();
}
});
}
})
.setContentTextSize(18)
.setType(new boolean[]{false, false, false, true, true, true}) // 只显示时分秒
.setLabel("年", "月", "日", "时", "分", "秒")
.setLineSpacingMultiplier(1.2f)
.setTextXOffset(0, 0, 0, 40, 0, -40)
.isCenterLabel(false)
.setDividerColor(0xFF24AD9D)
.build();
}
农历时间格式支持
Android-PickerView还支持农历时间选择,通过setLunarCalendar方法可以切换到农历显示模式:
pvCustomLunar = new TimePickerBuilder(this, new OnTimeSelectListener() {
@Override
public void onTimeSelect(Date date, View v) {
Toast.makeText(MainActivity.this, getTime(date), Toast.LENGTH_SHORT).show();
}
})
.setLunarCalendar(true) // 启用农历
.build();
自定义时间选择器效果预览
通过上述自定义方法,可以实现各种样式的时间选择器。以下是几种常见的自定义效果:
总结
Android-PickerView提供了丰富的API,支持从简单的时间单位显示控制到复杂的自定义布局,满足各种时间选择需求。主要自定义方式包括:
- 使用
setType控制显示的时间单位 - 通过
setLabel修改时间单位标签 - 使用
setRangDate限制时间选择范围 - 通过
setLayoutRes加载自定义布局文件 - 调整文字大小、颜色等样式属性
掌握这些自定义方法,可以让时间选择器更好地融入应用的整体设计风格,提升用户体验。更多高级用法可以参考项目中的示例代码app/src/main/java/com/bigkoo/pickerviewdemo/MainActivity.java。
希望本文能帮助你轻松实现符合需求的时间选择器,让应用界面更加专业和友好!如果你有其他自定义需求,可以查阅项目的官方文档或源码进一步探索。
【免费下载链接】Android-PickerView 项目地址: https://gitcode.com/gh_mirrors/and/Android-PickerView
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考




