datetimepicker 插件用法及参数说明

用例:
// 选择时间和日期
$(".form-datetime").datetimepicker({
    weekStart:1,
    todayBtn:1,
    autoclose:1,
    todayHighlight:1,
    startView:2,
    forceParse:0,
    showMeridian:1,
    format:"yyyy-mm-dd hh:ii"});// 仅选择日期
$(".form-date").datetimepicker({
    language:"zh-CN",
    weekStart:1,
    todayBtn:1,
    autoclose:1,
    todayHighlight:1,
    startView:2,
    minView:2,
    forceParse:0,
    format:"yyyy-mm-dd"});// 选择时间
$(".form-time").datetimepicker({
    language:"zh-CN",
    weekStart:1,
    todayBtn:1,
    autoclose:1,
    todayHighlight:1,
    startView:1,
    minView:0,
    maxView:1,
    forceParse:0,
    format:'hh:ii'});

参数说明:

weekStart

Integer. 默认值:0

一周从哪一天开始。0(星期日)到6(星期六)

startDate

Date. 默认值:开始时间

The earliest date that may be selected; all earlier dates will be disabled.

endDate

Date. 默认值:结束时间

The latest date that may be selected; all later dates will be disabled.

daysOfWeekDisabled

String, Array. 默认值: '', []

Days of the week that should be disabled. Values are 0 (Sunday) to 6 (Saturday). Multiple values should be comma-separated. Example: disable weekends: '0,6' or [0,6].

autoclose

Boolean. 默认值:false

当选择一个日期之后是否立即关闭此日期时间选择器。

startView

Number, String. 默认值:2, 'month'

日期时间选择器打开之后首先显示的视图。 可接受的值:

  • 0 or 'hour' for the hour view
  • 1 or 'day' for the day view
  • 2 or 'month' for month view (the default)
  • 3 or 'year' for the 12-month overview
  • 4 or 'decade' for the 10-year overview. Useful for date-of-birth datetimepickers.

minView

Number, String. 默认值:0, 'hour'

日期时间选择器所能够提供的最精确的时间选择视图。

maxView

Number, String. 默认值:4, 'decade'

日期时间选择器最高能展示的选择范围视图。

todayBtn

Boolean, "linked". 默认值: false

如果此值为true 或 "linked",则在日期时间选择器组件的底部显示一个 "Today" 按钮用以选择当前日期。如果是true的话,"Today" 按钮仅仅将视图转到当天的日期,如果是"linked",当天日期将会被选中。

todayHighlight

Boolean. 默认值: false

如果为true, 高亮当前日期。

keyboardNavigation

Boolean. 默认值: true

是否允许通过方向键改变日期。

forceParse

Boolean. 默认值: true

当选择器关闭的时候,是否强制解析输入框中的值。也就是说,当用户在输入框中输入了不正确的日期,选择器将会尽量解析输入的值,并将解析后的正确值按照给定的格式format设置到输入框中。

minuteStep

Number. 默认值: 5

此数值被当做步进值用于构建小时视图。对于每个 minuteStep 都会生成一组预设时间(分钟)用于选择。

pickerPosition

String. 默认值: 'bottom-right' (还支持 : 'bottom-left')

此选项当前只在组件实现中提供支持。通过设置选项可以讲选择器放倒输入框下方。

initialDate

Date or String. 默认值: new Date()

You can initialize the viewer with a date. By default it's now, so you can specify yesterday or today at midnight ...

方法:

.datetimepicker(options)

初始化日期时间选择器。

update

参数: None

使用当前输入框中的值更新日期时间选择器。

 
    
  1. $('#datetimepicker').datetimepicker('update');

setStartDate

参数:

  • startDate (String)

给日期时间选择器设置一个新的起始日期。

 
     
  1. $('#datetimepicker').datetimepicker('setStartDate','2012-01-01');

setEndDate

参数:

  • endDate (String)

给日期时间选择器设置结束日期。

 
      
  1. $('#datetimepicker').datetimepicker('setEndDate','2012-01-01');

setDaysOfWeekDisabled

参数:

  • daysOfWeekDisabled (String|Array)

Sets the days of week that should be disabled.

 
       
  1. $('#datetimepicker').datetimepicker('setDaysOfWeekDisabled',[0,6]);

事件(Events):
 
    
 
     
 
      
 
       

Datetimepicker 类暴露了一组event用以对日期进行操作。

show

当选择器显示时被触发。

hide

当选择器隐藏时被触发。

changeDate

当日期被改变时被触发。

 
         
  1. $('#date-end')
  2. .datetimepicker()
  3. .on('changeDate',function(ev){
  4. if(ev.date.valueOf()< date-start-display.valueOf()){
  5. ....
  6. }
  7. });



你可能感兴趣的:(插件,JavaScript)