jquery.cxcalendar.js日期选择器插件

jquery.cxcalendar.js日期选择器插件

更新: 2019-04-19

阅读:194

开源:GitHub

cxCalendar 是基于 jQuery 的日期选择器插件。
它灵活自由,你可以自定义外观,日期的范围,返回的格式等。
版本:
jQuery v1.7+

jQuery cxCalendar v1.5.4

使用方法

载入 CSS 文件

<link rel="stylesheet" href="jquery.cxcalendar.css">

载入 JavaScript 文件

<script src="jquery.js"></script>
<script src="jquery.cxcalendar.js"></script>
DOM 结构
<input id="element_id" type="text">

调用 cxCalendar

$("#element_id").cxCalendar();

设置全局默认值

// 需在引入 <script src="js/jquery.cxcalendar.js"></script> 之后,调用之前设置
$.cxCalendar.defaults.startDate = 1980;
$.cxCalendar.defaults.language = {
  monthList: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'], 
  weekList: ['Sun', 'Mon', 'Tur', 'Wed', 'Thu', 'Fri', 'Sat'] 
};


参数

  • startDate:起始日期 若指定年份,设置值为 4 位数的数字 若指定某一天,设置值为字符串或时间戳,该值能被new Date(value)处理
  • endDate:结束日期 若指定年份,设置值为 4 位数的数字 若指定某一天,设置值为字符串或时间戳,该值能被new Date(value)处理
  • date:默认日期 默认获取当前日期,自定义可使用字符串或时间戳,该值能被new Date(value)处理 ※ input 中的 value 值优先级要高级此值
  • type:日期类型 (v1.5 新增) 'date': 只选择日期 'datetime': 选择日期和时间
  • format:日期值格式 (自 v1.5 开始,之前版本的 type 更名为 format) 'YYYY': 年份,完整 4 位数字 'YY': 年份,仅末尾 2 位数字 'MM': 月份,数字带前导零(01-12) 'M': 月份(1-12) 'DD': 月份中的第几天,数字带前导零(01-31) 'D': 月份中的第几天(1-31) 'HH': 小时,24 小时格式,数字带前导零(00-23) 'H': 小时,24 小时格式(0-23) 'hh': 小时,12 小时格式,数字带前导零(01-12) 'h': 小时,12 小时格式(1-12) 'mm': 分钟,数字带前导零(00-59) 'm': 分钟(0-59) 'ss': 分钟,数字带前导零(00-59) 's': 分钟(0-59) 'TIME': 时间戳 'STRING': 日期的字符串,例:Wed Jul 28 1993

方法

  • show():显示面板
  • hide():隐藏面板
  • getDate(style) :获取当前选择的日期(style 格式与参数 format 相同)
  • setDate(value) :传入一个字符串来设置日期
  • setDate(year, month, day):分别传入年、月、日来设置日期
  • gotoDate(value):传入一个字符串来调整日期(只是显示面板变化,不会进行设置值)
  • gotoDate(year, month):分别传入年、月来调整日期(只是显示面板变化,不会进行设置值)
  • clearDate():清除日期值
  • setOptions(opt):重新设置参数