js中的时间控件WdatePicker

js中的时间控件WdatePicker
My97日期控件 My97 DatePicker Ver 3.0.1
3.0.1修正的问题
1.修正与很多JS库(如prototype,JQuery,dwr等)的冲突问题
2.解决不能“后退”的问题
3.解决IE6中,今天和选中的日期没有以其它颜色显示的问题
4.解决日期选择器被动态增加的iframe覆盖的问题

一. 注意事项和简介

1. 注意事项
1. My97DatePicker目录是一个整体,不可破坏里面的目录结构,也不可对里面的文件改名,可以改目录名
2. My97DatePicker.htm是必须文件,不可删除
3. 各目录及文件的用途:
WdatePicker.js(导入文件,在调用的地方仅需使用该文件)
config.js(主配置文件) calendar.js(日期库主文件) My97DatePicker.htm(临时页面文件)
目录lang(存放语言文件) 目录skin(存放皮肤的相关文件)
4. 在input里加上class="Wdate"就会在选择框右边加上日期图标,如果你不喜欢这个样式,可以把class="Wdate"去掉,
另外也可以通过修改skin目录下的WdatePicker.css文件来修改样式


2. 更新和修正的内容
1.优化了速度和内存占用
2.增加realValue 的格式设置
3.增强日期范围限制
可以使用#Year# #Month# #Day# #lastDay#
如:本月最后一天#Year#-#Month#-#lastDay#
明年今天(注意有运算的地方,比如+1,必须用{}) : {#Year#+1}-#Month#-#Day#
函数 #F{function}
比如用另一个框(id是test1)的值作为最小日期,则 MINDATE="#F{$('test1').value}"
4.当日期格式设置为 %h:%m:%s 只有时间选择了
5.增加年份月份导航,增加清空按钮
6.增加显示位置设置(上面 下面 自动(默认))
7.增加文件包路径设置(在wdatepicker.js文件里,默认为空,程序会自动计算路径)
8.增加自定义触发事件,可以在日期框添加属性 onpicked="function(){}" 来自定义触发事件
9.增加多语言自动选择功能,系统会根据用户浏览器语言自动选择 简体 繁体 和英文

修正抖屏
修正在XHTML 1.0下不兼容的问题
修正2007-3-31 修改成2月份时变为2007-2-31的bug
修正frame中跳转时没销毁的bug
修正css路径,不必将文件包放根目录下了

二. 功能介绍

1. 自动切换语言(新增)
日期控件会根据用户的浏览器语言自动切换,自带3中语言,简体中文,繁体中文和英文
相关配置文件在 lang目录


2. 支持自定义皮肤和动态切换皮肤
默认皮肤default:即skin=default 主调函数:onfocus="new WdatePicker(this)"
示例2-1:
whyGreen皮肤:即skin=whyGreen 主调函数:onfocus="new WdatePicker(this,null,false,'whyGreen')"
注意:'whyGreen'要带上单引号,因为是字符串
示例2-2:


3. 自定义事件(onPicked)(新增)
事件名称:onPicked 事件触发条件:选择日期的时候
示例:利用onPicked实现日期选择联动(选择第一个日期的时候,第二个日期选择框自动弹出)

"hts" onfocus="new WdatePicker(this,'%Y年%M月%D日',false)" maxdate="#F{$('hte').value}" onPicked="$('hte').onfocus()"/>
注: hte 是后面那个选择框的id
合同有效期从 到


4.日期范围限制(增强)

4.1 日期范围限制(静态限制,日期格式必须与config.js中的realValueShortFmt一致)
相关属性:MINDATE(最小日期) MAXDATE(最大日期)

示例 4.1-1(限制日期的范围是 2006-10-8到2008-12-20 ):

4.2 日期范围限制(动态限制)
相关属性:MINDATE(最小日期) MAXDATE(最大日期)
动态变量: #Year#(今年) #Month#(本月) #Day#(今天) #lastDay#(本月最后一天)
如 #Year#-#Month#-#Day#(表示今天) #Year#-#Month#-{#Day#+1}(表示明天) {#Year#+1}-#Month#-#Day#(表示明年的今天)
注意:如果有运算的地方必须用{}括起来,如上面例子的{#Day#+1},必须用{}
自定义函数: #F{}表示函数,{}之间是函数的内容 例子见4.2-1
示例 4.2-1(动态限制日期的范围 使用了自定义函数 前面的日期不能大于后面的日期 后面的日期的最大值是:2020-1-1):


合同有效期从 到

示例 4.2-2(动态限制日期的范围 只能选择今天以前的日期(包括今天))


示例 4.2-3(动态限制日期的范围 只能选择今天以后的日期(不包括今天))


示例 4.2-4(动态限制日期的范围 只能选择本月的日期 1号至本月最后一天)




5. 根据网页大小自动选择显示位置
调用形式同示例1-1,点右下角的日期框就能看到效果

示例5-1:

6

7. 支持日期和时间的编辑,编辑时自动跳转到对应月份和时间
不知道你是否已经注意到,当日期框里面有值时,右下角的按钮会变成确定,现在你可以尝试对下面框中的日期和时间进行编辑
主调函数:onfocus="new WdatePicker(this)"
示例5-1:
主调函数:onfocus="new WdatePicker(this,'%Y-%M-%D %h:%m:%s',true)"
示例5-2:


8. 支持自定义时间和日期格式(增强)
8.1 年月日时分秒
主调函数:onfocus="new WdatePicker(this,'%Y年%M月%D日 %h时%m分%s秒',true)"
示例8-1:
那么像这样的文本框我们存入数据库时这么取得实际的日期值呢,别急,用

这个函数 document.getElementByIdx_x('textbox2').getValue()
8.2 时分秒
主调函数:onfocus="new WdatePicker(this,'%h:%m:%s',true,'whyGreen')"
示例8-2:
8.3 年月
主调函数:onfocus="new WdatePicker(this,'%Y年%M月',false,'whyGreen')"
示例8-2:
8.4 年月日时分
主调函数:onfocus="new WdatePicker(this,'%Y-%M-%D %h:%m',true)"
示例8-2:


9. 增强的自动纠错功能,纠错处理可设置为3种模式 1.提示(默认) 2.自动纠错 3.标记
您可以 在下面的日期框中填入一个不合法的日期(如:1997-02-29),再尝试离开焦点
示例9-1
另:超出日期限制范围的日期也被认为是一个不合法的日期
示例9-2的最大日期是2000-1-10 ,如果在下框中填入的日期 大于 2000-1-10(如2000-1-12)也会被认为是不合法的日期

示例9-2


10. 完美支持FireFox
您可以使用FireFox浏览其来浏览此页来查看效果



三. 配置说明




$position = 0;

$dpPath = '';


var dpcfg = {};

dpcfg.skin = "default";

dpcfg.dateFmt = "%Y-%M-%D";

dpcfg.realValueShortFmt = "%Y-%M-%D";
dpcfg.realValueLongFmt = "%Y-%M-%D %h:%m:%s";

dpcfg.showTime = false;

dpcfg.highLineWeekDay = true;

dpcfg.minDate = "1900-1-1";
dpcfg.maxDate = "2099-12-30";

dpcfg.errDealMode = 0;


dpcfg.errAlertMsg = "不合法的日期格式或者日期超出限定范围,需要撤销吗?";

dpcfg.aWeekStr = ["日","一","二","三","四","五","六"];
dpcfg.aMonStr = ["一月","二月","三月","四月","五月","六月","七月","八月","九月","十月","十一","十二"];
dpcfg.clearStr = "清空";
dpcfg.todayStr = "今天";
dpcfg.okStr = "确定";
dpcfg.timeStr = "时间";


.Wdate{
border:#999 1px solid;
height:18px;
background:url(datePicker.gif) no-repeat right;
}

.WdateFmtErr{
font-weight:bold;
color:red;
}


四. 如何使用

1. 在使用该日期控件的文件中加入JS库(仅这一个文件即可,其他文件会自动引入,请勿删除或改名), 代码如下
注:src="datepicker/WdatePicker.js" 请根据您的实际情况改变路径
2.加上主调函数 onfocus="new WdatePicker('el','dateFmt','showsTime','skin')"
相信大家已经知道怎么用了,如果还不明白请QQ我:9589876
主调函数的使用方法和说明
1.主调方法:
onfocus="new WdatePicker('el','dateFmt','showsTime','skin')"
这个是JS库的主调函数:
el: 表示返回日期的对象或对象名称,提供2种调用方式
dateFmt: 自定义的日期格式 %Y %M %D %h %m %s 表示年月日时分秒(注意大小写) 默认是%Y-%M-%D
showsTime: 布尔型变量 true表示带时间选择 默认为false
skin: 皮肤的名称 本包自带2款皮肤 分别为 default 和 whyGreen
2.属性(注意大小写,日期

格式必须与config.js中的realValueShortFmt一致)
MINDATE: 日期最小值 格式为: 2000-1-1 或 2000/1/1 默认为:1900-1-1
MAXDATE: 日期最大值 格式为: 2008-1-1 或 2008/1/1 默认为:2099-12-30
3 取值的方法(注意:返回值的格式在 config.js中的 realValueShortFmt realValueLongFmt 中定义)
getValue(): 这个属性用于记录日期框的日期值 通常情况下getValue()和 日期框的value 属性是一样的,当进行自定义日期格式的时候这2个值就不一样了
例如: 当 格式字符串: %Y年%M月%D日 %h时%m分%s秒 时 日期框中的VALUE是:2000年1月1日 12时00分00秒 而getValue()值: 2000-1-1 12:00:00
我想通过这个例子应该很清楚了,2000年1月1日 12时00分00秒对于用户来说是一个很直观的日期,但对于计算机来说是一个不可识别的日期,在用户选择的时候我们可以使用%Y年%M月%D日 %h时%m分%s秒格式化日期给用户一个友好的日期格式,但是在数据存储的时候我们不可能把2000年1月1日 12时00分00秒直接存入数据库的,getValue()就是为了解决这个问题而设计的.