转载:https://www.cnblogs.com/dazhangli/p/9002329.html
目录
- datetimepicker用法总结
- 目录
- 简述
- 官方文档
- 选项属性
- 1 format 格式
- 2 weekStart 一周从哪一天开始
- 3 startDate 开始时间
- 4 endDate 结束时间
- 5 daysOfWeekDisabled 一周的周几不能选
- 6 autoclose 选完时间后是否自动关闭
- 7 startView 选完时间首先显示的视图
- 8 minView 最精确的时间
- 9 maxView 最高能展示的时间
- 10 todayBtn 当天日期按钮
- 11 todayHighlight 当天日期高亮
- 12 keyboardNavigation 方向键改变日期
- 13 language 语言
- 14 forceParse 强制解析
- 15 minuteStep 步进值
- 16 pickerPosition 选择框位置
- 17 showMeridian 是否显示上下午
- 18 initialDate 初始化日期时间
1. 简述
最近因为项目,在用Bootsrapt写一些前台,遇到datetimepicker时,在使用方面出现了一些问题,索性记录下来,能用到看看,用不到留着自己参考。
2. 官方文档
附上官方文档链接,需要的人们传送门。
官方文档大部分都是中文,已经不错了,但是还是在很多问题上没有给出例子。博主,把一些常用的在后文附上,有错误请不吝赐教。
3. 选项(属性)
总体调用格式为:
jsp中:
<input type="text" id="demo" >
- 1
js中:
$("#demo").datetimepicker();
- 1
3.1 format — 格式
String类型
默认值: ‘mm/dd/yyyy’
这个是最重要最常用的属性之一了。控制显示格式就是固定值得个性化搭配。
比如,显示 2016-04-21 19:21
$("#demo").datetimepicker({ format: 'yyyy-mm-dd hh:ii' });
- 1
- 2
- 3
又比如,你就是喜欢反人类的格式,那你可以这样:
$("#demo").datetimepicker({ format: 'hh-yyyy-ii mm:dd' });
- 1
- 2
- 3
这个是扯淡的,就是个意思,你可以自己设计样式,但是里面的字母都代表不同属性:
符号 | 意义 |
---|---|
p | 12小时制且小写(‘am’ or ‘pm’) |
P | 12小时制且大写(‘AM’ or ‘PM’) |
s | 秒,前面不补0 |
ss | 秒,前面补0 |
i | 分,前面不补0 |
ii | 分,前面补0 |
h | 时,24小时制,前面不补0 |
hh | 时,24小时制,前面补0 |
H | 时,12小时制,前面不补0 |
HH | 时,12小时制,前面补0 |
d | 日,前面不补0 |
dd | 日,前面补0 |
m | 月,数字表示,前面不补0 如:4 |
mm | 月,数字表示,前面补0 如:04 |
M | 月,缩写表示,前面补0 如:Apr |
MM | 月,全称表示,前面补0 如:April |
yy | 年,后两位 如:16 |
yyyy | 年,全部 如:2016 |
3.2 weekStart — 一周从哪一天开始
Integer类型
默认值:0
0(星期日)到6(星期六)
例如:
$("#demo").datetimepicker({ weekStart: 3 });
- 1
- 2
- 3
效果:
3.3 startDate — 开始时间
Date类型
默认值:开始时间
之前的日期都不能选择,这个时间之后的时间才能选择。
咱们做一个常用的Demo,就是只能选现在之后的时间:
例如:
var date = new Date(); $("#demo").datetimepicker({ startDate: date });
- 1
- 2
- 3
- 4
效果卡件上图中的灰色部分:
3.4 endDate— 结束时间
Date类型
默认值:结束时间
这个时间后面的不能再选择。
用法同上,不再赘述。
3.5 daysOfWeekDisabled — 一周的周几不能选
String, Array类型
默认值:”, []
0(星期日)到6(星期六)
可以有多个。
例如:
$("#demo").datetimepicker({ daysOfWeekDisabled: [0,4,6] });
- 1
- 2
- 3
或者:
$("#demo").datetimepicker({ daysOfWeekDisabled: '0,4,6' });
- 1
- 2
- 3
效果:
3.6 autoclose — 选完时间后是否自动关闭
Boolean类型
默认值:false
当选择一个日期之后是否立即关闭此日期时间选择器。
3.7 startView — 选完时间首先显示的视图
Number, String类型
默认值:2, ‘month’
日期时间选择器打开之后首先显示的视图。
可接受的值:
值 | 意义 |
---|---|
0 | 从小时视图开始,选分 |
1 | 从天视图开始,选小时 |
2 | 从月视图开始,选天 |
3 | 从年视图开始,选月 |
4 | 从十年视图开始,选年 |
3.8 minView — 最精确的时间
Number, String类型
默认值:0, ‘hour’
日期时间选择器所能够提供的最精确的时间选择视图。
可接受的值:
值 | 意义 |
---|---|
0 | 从小时视图开始,选分 |
1 | 从天视图开始,选小时 |
2 | 从月视图开始,选天 |
3 | 从年视图开始,选月 |
4 | 从十年视图开始,选年 |
例如:
$("#demo").datetimepicker({ minView : 2 });
- 1
- 2
- 3
上例中选完日后,不在出现下级时间选择。
3.9 maxView — 最高能展示的时间
Number, String类型
默认值:4, ‘decade’
日期时间选择器最高能展示的选择范围视图。
用法同上,不在赘述。
3.10 todayBtn — 当天日期按钮
Boolean, “linked”类型
默认值:false’
如果此值为true 或 “linked”,则在日期时间选择器组件的底部显示一个 “Today” 按钮用以选择当前日期。如果是true的话,”Today” 按钮仅仅将视图转到当天的日期,如果是”linked”,当天日期将会被选中。
例如:
$("#demo").datetimepicker({ todayBtn : true });
- 1
- 2
- 3
效果:
3.11 todayHighlight — 当天日期高亮
Boolean类型
默认值:false
如果为true, 高亮当前日期。
不再举例。
3.12 keyboardNavigation — 方向键改变日期
Boolean类型
默认值:false
是否允许通过方向键改变日期。
不再举例。
3.13 language — 语言
String类型
默认值:’en’
中文:’zh-CN’
3.14 forceParse — 强制解析
Boolean类型
默认值:true
就是你输入的可能不正规,但是它胡强制尽量解析成你规定的格式(format)
3.15 minuteStep — 步进值
Number类型
默认值:5
此数值被当做步进值用于构建小时视图。就是最小的视图是每5分钟可选一次。是以分钟为单位的。
3.16 pickerPosition — 选择框位置
String类型
默认值:’bottom-right’
还支持 : ‘bottom-left’,’top-right’,’top-left’
可以试试看,他拿出位置会发生变化。
3.17 showMeridian — 是否显示上下午
Boolean类型
默认值:false
在日期和小时选择界面,出现上下午的选项
3.18 initialDate — 初始化日期时间
Date or String类型
默认值:new Date()
在打开时默认选当时的时间,显示在View中。