datetimepicker 插件用法及参数说明

最新推荐文章于 2025-03-09 17:43:45 发布

Casanover

最新推荐文章于 2025-03-09 17:43:45 发布

阅读量2.4k

点赞数

分类专栏： JavaScript

JavaScript 专栏收录该内容

24 篇文章

订阅专栏

本文详细介绍了日期时间选择器的配置方法及参数说明，包括如何设置日期选择范围、禁用特定日期等，并提供了初始化、更新及事件监听的方法示例。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

用例：

// 选择时间和日期
$(".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

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

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

   
   
   
   
    
    setStartDate
    
    参数:
    
    startDate (String)
    
    给日期时间选择器设置一个新的起始日期。
    
         
     $('#datetimepicker').datetimepicker('setStartDate','2012-01-01');
     
     
      
      

     
     
     
     
      
      setEndDate
      
      参数:
      
      endDate (String)
      
      给日期时间选择器设置结束日期。
      
             
       $('#datetimepicker').datetimepicker('setEndDate','2012-01-01');
       
       
        
        

       
       
       
       
        
        setDaysOfWeekDisabled
        
        参数:
        
        daysOfWeekDisabled (String|Array)
        
        Sets the days of week that should be disabled.
        
                 
         $('#datetimepicker').datetimepicker('setDaysOfWeekDisabled',[0,6]);

事件（Events）：

   
   
    
         
     
      
             
       
        
                 
         
          
          
           
           
          
          
          
          
           
           Datetimepicker 类暴露了一组event用以对日期进行操作。
           
           show
           
           当选择器显示时被触发。
           
           hide
           
           当选择器隐藏时被触发。
           
           changeDate
           
           当日期被改变时被触发。
           
                       
            $('#date-end')
.datetimepicker()
.on('changeDate',function(ev){
if(ev.date.valueOf()< date-start-display.valueOf()){
....
}
});
            
            
             
             

            
            
            
            
             
             

            
            
            
            
             
             

            
            
            
            
             
             								原址：http://blog.youkuaiyun.com/hurtheart517/article/details/51474324