jeDate V6.5.0 是一款原生JS开发、不依赖任何第三方库的大众化日期控件。她身兼多职,虽不是万能的,但却是功能强大且多样化的日期选择工具,除了包含单双面板、区域选择、多语言、日历固定、有效无效日期、日期时间戳转换、日期加减、限制时分秒、初始化日期加减N、日期标注点、设定年月(YYYY-MM)、日期范围限制、开始日期设定、自定义日期格式、当天的前后若干天返回、时分秒选择、智能响应、自动纠错、节日识别等常规功能外,根据不同的日期格式显示不同内容,还拥有更多趋近完美的解决方案。
核心特性
原生轻量设计 jeDate完全基于原生JavaScript开发,无需依赖jQuery等第三方库,体积小巧,加载速度快,对页面性能影响极小。
多格式支持 支持多种日期格式配置,包括:
- YYYY(年份)
- YYYY-MM(年月)
- YYYY-MM-DD(年月日)
- hh:mm:ss(时分秒)
- YYYY-MM-DD hh:mm:ss(完整日期时间)
国际化语言 内置多语言包,支持简体中文、繁体中文、英文等语言切换,满足全球化应用需求。
智能交互体验
- 自动纠错功能,防止用户输入错误日期
- 智能响应,适配不同设备屏幕
- 节日识别,自动显示农历节日
快速开始
安装方式 使用npm安装:
npm install jquery.jedate
使用Git安装:
git clone https://gitcode.com/gh_mirrors/je/jeDate
基础使用 在HTML中添加输入框:
<input class="datainp" id="indate" type="text" placeholder="请选择" readonly>
JavaScript初始化:
jeDate("#indate", {
format: "YYYY-MM-DD hh:mm:ss",
minDate: "1900-01-01 00:00:00",
maxDate: "2099-12-31 23:59:59"
});
配置选项详解
基础配置
format:日期格式,默认"YYYY-MM-DD hh:mm:ss"minDate:最小可选日期maxDate:最大可选日期language:语言配置multiPane:是否双面板显示
显示控制
isShow:是否显示为固定日历onClose:选中日期后是否关闭弹层fixed:是否静止定位
功能开关
isTime:是否开启时间选择isClear:是否显示清空按钮isToday:是否显示今天按钮isYes:是否显示确定按钮
高级功能
区域范围选择 支持日期范围选择功能:
jeDate("#test08", {
format: "YYYY-MM-DD",
range: " 至 "
});
自定义主题 通过theme配置自定义颜色:
jeDate("#testblue", {
theme: {
bgcolor: "#00A1CB",
pnColor: "#00CCFF"
},
multiPane: false,
range: " ~ ",
format: "YYYY-MM-DD hh:mm:ss"
});
快捷方式 配置常用日期快捷选择:
jeDate("#short", {
format: "YYYY-MM-DD",
shortcut: [
{name: "一周", val: {DD: 7}},
{name: "一个月", val: {DD: 30}},
{name: "二个月", val: {MM: 2}},
{name: "三个月", val: {MM: 3}},
{name: "一年", val: {DD: 365}}
]
});
有效无效日期控制 通过valiDate配置特定日期是否可选:
jeDate("#test20", {
valiDate: ["0[4-7]$,1[1-5]$,2[58]$", true],
format: "YYYY年MM月DD日"
});
样式定制
jeDate提供了完整的CSS样式文件,位于skin/jedate.css,包含以下主要样式类:
.jedate:主容器样式.jedate-header:头部样式.jedate-content:内容区域样式.jedate-footbtn:底部按钮样式
字体图标 项目使用自定义字体图标,支持多种浏览器兼容性:
- EOT格式:IE9及以下
- WOFF格式:现代浏览器
- TTF格式:Chrome、Firefox等
- SVG格式:iOS设备
实际应用示例
表单日期选择
jeDate("#birthday", {
format: "YYYY-MM-DD",
maxDate: jeDate.nowDate(0)
});
时间范围筛选
jeDate("#dateRange", {
format: "YYYY-MM-DD",
range: " ~ ",
multiPane: false
});
固定日历显示
jeDate("#calendar", {
isShow: false,
format: "YYYY-MM-DD"
});
技术优势
性能优化
- 优化的DOM操作和事件处理
- 大数据量下依然保持流畅运行
- 内存占用小,适合长期运行的应用
兼容性保障
- 支持IE8+及其他现代浏览器
- 响应式设计,适配移动设备
- 跨平台一致性体验
开发建议
最佳实践
- 根据实际需求选择合适的日期格式
- 合理设置日期范围限制,避免无效选择
- 使用回调函数处理选中后的业务逻辑
错误处理 jeDate内置了完善的错误处理机制,当遇到不支持的配置或格式时会给出明确的提示信息。
总结
jeDate作为一款功能全面、性能优秀的原生JavaScript日期选择器,为开发者提供了简单易用且高度可定制的日期选择解决方案。无论你是构建简单的表单应用还是复杂的企业级系统,jeDate都能满足你的需求,让你的日期选择体验更加优雅和专业。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考




