DateTimePicker参数设置

DateTimePicker提供丰富的参数设置,帮助个性化设置使用本插件。

DateTimePicker参数设置方法

在js中初始化DateTimePicker时,设置你需要的各项参数

$('#datetimepicker').datetimepicker({
  参数A:参数值A,
  参数B:参数值B,
  ...
  参数N:参数值N
});

例如,设置DateTimePicker黑色背景主题,设置时间选择格式为“年-月-日 时:分”

$('#datetimepicker').datetimepicker({
  theme:'dark',
  format:'Y-m-d H:i'
});

效果(点击下方输入框的空白处)

DateTimePicker参数说明

lazyInit.懒加载

  • 字段:lazyInit
  • 类型:Boolean
  • 描述:只在用户交互时才初始化插件,加快网页包含大量初始化插件时的加载速度
  • 默认:false

parentID

  • 字段:parentID
  • 类型:String
  • 描述:将datetimepicker附加到这个元素上,它可以是一个选择器,也可以是一个DOM/JQuery元素。
  • 默认:body
  • 示例
  • {parentID:'#parent'}

value

  • 字段:value
  • 类型:String
  • 描述:当前datetimepicker值。如果设置了此参数,则忽略input.value。
  • 默认:null
  • 示例
  • {value:'12.03.2018',
     format:'d.m.Y'}

lang.语言

  • 字段:
  • 类型:String
  • 描述:支持i18n国际化,可以设定各类语言。常用语言:en - English,zh - Simplified Chinese (简体中文),zh-TW - Traditional Chinese (繁體中文),de - German,es - Spanish,fr - French,ja - Japanese ,kr - Korean,ru - Russian
  • 默认:en
  • 示例
  • $.datetimepicker.setLocale('zh');

format.日期格式

  • 字段:format
  • 类型:String
  • 描述:将datetimepicker选择的日期时间格式化为指定格式
  • 默认:Y/m/d H:i
  • 示例
  • {format:'Y-m-d H:i'}

formatDate

  • 字段:formatDate
  • 类型:String
  • 描述:minDate 和 maxDate的日期格式
  • 默认:Y/m/d
  • 示例
  • {formatDate:'d.m.Y'}

formatTime

  • 字段:formatTime
  • 类型:String
  • 描述:minTime 和 maxTime的时间格式
  • 默认:H:i
  • 示例
  • {formatTime:'H'}

step

  • 字段:step
  • 类型:Int
  • 描述:设置时间时分的间隔
  • 默认:60
  • 示例
  • {step:5}

closeOnDateSelect

  • 字段:closeOnDateSelect
  • 类型:Boolean
  • 描述:true 设置datepicker可点击 false 设置datepicker不可点击
  • 默认:false
  • 示例
  • {closeOnDateSelect:true}

closeOnWithoutClick

  • 字段:closeOnWithoutClick
  • 类型:Boolean
  • 描述:true 设置点击input可以隐藏datetimepicker false 设置点击input不可以隐藏datetimepicker
  • 默认:true
  • 示例
  • {closeOnWithoutClick :false}

validateOnBlur

  • 字段:validateOnBlur
  • 类型:Boolean
  • 描述:失去焦点时验证datetime值输入,如果值是无效的datetime,则插入当前日期时间值
  • 默认:true
  • 示例
  • {validateOnBlur:false}

timepicker

  • 字段:timepicker
  • 类型:Boolean
  • 描述:true 显示timepicker false 隐藏timepicker
  • 默认:true
  • 示例
  • {timepicker:false}

datepicker

  • 字段:datepicker
  • 类型:Boolean
  • 描述:true 显示datepicker false 隐藏datepicker
  • 默认:true
  • 示例
  • {datepicker:false}

weeks

  • 字段:weeks
  • 类型:Boolean
  • 描述:true 显示年度周数 false 隐藏年度周数
  • 默认:false
  • 示例
  • {weeks:true}

theme

  • 字段:theme
  • 类型:String
  • 描述:选择主题,支持'default','dark'
  • 默认:default
  • 示例
  • {theme:'dark'}

minDate

  • 字段:minDate
  • 类型:Multi
  • 描述:设置datepicker最小的限制日期
  • 默认:false
  • 示例
  • {minDate:0} // today
    {minDate:'2013/12/03'}
    {minDate:'-1970/01/02'} // yesterday
    {minDate:'05.12.2013',formatDate:'d.m.Y'}

maxDate

  • 字段:maxDate
  • 类型:Multi
  • 描述:设置datepicker最大的限制日期
  • 默认:false
  • 示例
  • {maxDate:0} // today
    {maxDate:'2013/12/03'}
    {maxDate:'+1970/01/02'} // tomorrow
    {maxDate:'05.12.2013',formatDate:'d.m.Y'}

minTime

  • 字段:minTime
  • 类型:Multi
  • 描述:设置timepicker最小的限制时间
  • 默认:false
  • 示例
  • {minTime:0,}// now
    {minTime:new Date()}
    {minTime:'12:00'}
    {minTime:'13:45:34',formatTime:'H:i:s'}

maxTime

  • 字段:maxTime
  • 类型:Multi
  • 描述:设置timepicker最大的限制时间
  • 默认:false
  • 示例
  • {maxTime:0,}
    {maxTime:'12:00'}
    {maxTime:'13:45:34',formatTime:'H:i:s'}

defaultDate

  • 字段:defaultDate
  • 类型:Multi
  • 描述:如果input value输入值为空,则datepicker默认设置日期使用defaultDate
  • 默认:false
  • 示例
  • {defaultDate:'1987/12/03'}
    {defaultDate:new Date()}
    {defaultDate:'+1970/01/02'} // tomorrow
    {defaultDate:'08.12.1986',formatDate:'d.m.Y'}

defaultTime

  • 字段:defaultTime
  • 类型:Multi
  • 描述:如果input value输入值为空,则timepicker默认设置时间使用defaultTime<
  • 默认:false
  • 示例
  • {defaultTime:'05:00'}
    {defaultTime:'33-12',formatTime:'i-H'}

allowTimes

  • 字段:allowTimes
  • 类型:List
  • 描述:设置timepicker显示的可选时间列表
  • 默认:[]
  • 示例
  • {allowTimes:[
      '09:00',
      '11:00',
      '12:00',
      '21:00'
    ]}