Android DateTimePicker(一个简单、漂亮的日期时间选择器)
程序员文章站
2022-06-25 17:27:33
DateTimePicker 一个简约、漂亮的日期时间选择器,支持大面积自定义UI,内置日期时间选择弹窗,基于 Google BottomSheetDialog,可直接使用。预览快速体验点击下载如何引入Step 1. 添加 JitPack repositoryallprojects {repositories {...maven { url "https://jitpack.io" }}}Step 2. 添加 Gradle依赖dep....
DateTimePicker 一个简约、漂亮的日期时间选择器,支持大面积自定义UI,内置日期时间选择弹窗,基于 Google BottomSheetDialog,可直接使用。
预览
快速体验
如何引入
Step 1. 添加 JitPack repository
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
Step 2. 添加 Gradle依赖
dependencies {
...
//为了防止不必要的依赖冲突,0.0.3开始需要自行依赖google material库
implementation 'com.google.android.material:material:1.1.0'
//查看最新版本请前往github,仅支持androidx
implementation 'com.github.loperSeven:DateTimePicker:0.1.0'
}
如何使用
卡片弹窗
最简单的使用方式
CardDatePickerDialog.builder(this) .setTitle("SET MAX DATE") .setOnChoose(listener = object :CardDatePickerDialog.OnChooseListener{ override fun onChoose(millisecond: Long) { } }).build().show()
所有可配置属性
CardDatePickerDialog.builder(context) .setTitle("CARD DATE PICKER DIALOG") .setDisplayType(displayList) .setBackGroundModel(model) .showBackNow(true) .setDefaultTime(defaultDate) .setMaxTime(maxDate) .setMinTime(minDate) .setThemeColor(color) .showDateLabel(true) .showFocusDateInfo(true) .setLabelText("年","月","日","时","分") .setOnChoose("选择",object :CardDatePickerDialog.OnChooseListener{ override fun onChoose(millisecond: Long) { } }) .setOnCancel("关闭",object :CardDatePickerDialog.OnCancelListener{ override fun onCancel() { } }).build().show()
可配置属性说明
- 设置标题
fun setTitle(value: String)
- 是否显示回到当前按钮
fun showBackNow(b: Boolean)
- 是否显示选中日期信息
fun showFocusDateInfo(b: Boolean)
- 显示模式
// model 分为:CardDatePickerDialog.CARD//卡片,CardDatePickerDialog.CUBE//方形,CardDatePickerDialog.STACK//顶部圆角 // model 允许直接传入drawable资源文件id作为弹窗的背景,如示例内custom fun setBackGroundModel(model: Int)
- 设置主题颜色
fun setThemeColor(@ColorInt themeColor: Int)
- 设置显示值
fun setDisplayType(vararg types: Int)
fun setDisplayType(types: MutableList<Int>)
- 设置默认时间
fun setDefaultTime(millisecond: Long)
- 设置范围最小值
fun setMinTime(millisecond: Long)
- 设置范围最大值
fun setMaxTime(millisecond: Long)
- 是否显示单位标签
fun showDateLabel(b: Boolean)
- 设置标签文字
/**
*示例
*setLabelText("年","月","日","时","分")
*setLabelText("年","月","日","时")
*setLabelText(month="月",hour="时")
*/ fun setLabelText(year:String=yearLabel,month:String=monthLabel,day:String=dayLabel,hour:String=hourLabel,min:String=minLabel)
- 绑定选择监听
/**
*示例
*setOnChoose("确定")
*setOnChoose(listener = object :CardDatePickerDialog.OnChooseListener{
override fun onChoose(millisecond: Long) {
}
})
*setOnChoose("确定",object :CardDatePickerDialog.OnChooseListener{
override fun onChoose(millisecond: Long) {
}
})
*/ fun setOnChoose(text: String = "确定", listener: OnChooseListener?=null)
- 绑定取消监听
/**
*示例
*setOnCancel("取消")
*setOnCancel(listener = object :CardDatePickerDialog.OnCancelListener{
override fun onCancel() {
}
})
*setOnCancel("取消",object :CardDatePickerDialog.OnCancelListener{
override fun onCancel() {
}
})
*/ fun setOnCancel(text: String = "取消", listener: OnCancelListener?=null)
日期时间选择控件
xml中
<com.loper7.date_time_picker.DateTimePicker android:id="@+id/dateTimePicker" android:layout_width="match_parent" android:layout_height="wrap_content" app:showLabel="true" app:textSize="16sp" app:themeColor="#FF8080" />
代码中
- 设置监听
dateTimePicker.setOnDateTimeChangedListener(object :DateTimePicker.OnDateTimeChangedListener{ override fun onDateTimeChanged(view: DateTimePicker?, millisecond: Long) { } })
以上为最简单的使用方式
更多设置
- 设置显示状态
DateTimePicker支持显示 年月日时分 五个选项的任意组合,显示顺序以此为年、月、日、时、分,setDisplayType中可无序设置。
dateTimePicker.setDisplayType(intArrayOf( DateTimePicker.YEAR,//显示年 DateTimePicker.MONTH,//显示月 DateTimePicker.DAY,//显示日 DateTimePicker.HOUR,//显示时 DateTimePicker.MIN))//显示分
- 设置默认选中时间
dateTimePicker.setDefaultMillisecond(defaultMillisecond)//defaultMillisecond 为毫秒时间戳
- 设置允许选择的最小时间
dateTimePicker.setMinMillisecond(minMillisecond)
- 设置允许选择的最大时间
dateTimePicker.setMaxMillisecond(maxMillisecond)
- 是否显示label标签(选中栏 年月日时分汉字)
dateTimePicker.showLabel(true)
- 设置主题颜色
dateTimePicker.setThemeColor(ContextCompat.getColor(context,R.color.colorPrimary))
- 设置字体大小
设置的字体大小为选中栏的字体大小,预览字体会根据字体大小等比缩放
dateTimePicker.setTextSize(15)//单位为sp
- 设置标签文字
//全部 dateTimePicker.setLabelText(" Y"," M"," D"," Hr"," Min") //指定 dateTimePicker.setLabelText(min = "M")
Github
更多详细属性可前往Github查看,也可以通过isuess提出你的问题,让我们共同优化DateTimePicker。
本文地址:https://blog.csdn.net/qq_24257167/article/details/108144123