JS日曆插件 - My97 DatePicker用法詳解

1、簡介

1. 注意事項

（1）My97DatePicker目錄是一個總體,不可破壞裏面的目錄結構,也不可對裏面的文件更名,能夠改目錄名；

（2）各目錄及文件的用途:

        WdatePicker.js 配置文件,在調用的地方僅需使用該文件,可多個共存,以xx_WdatePicker.js方式命名

        config.js 語言和皮膚配置文件,無需引入(4.8之後合併入WdatePicker.js)

        calendar.js 日期庫主文件,無需引入

        目錄lang 存放語言文件,你能夠根據須要清理或添加語言文件

        目錄skin 存放皮膚的相關文件,你能夠根據須要清理或添加皮膚文件包

（3）當WdatePicker.js裏的屬性:$wdate=true時,在input里加上class="Wdate"就會在選擇框右邊出現日期圖標,若是您不喜歡這個樣式,能夠把class="Wdate"去掉,另外也能夠經過修改skin目錄下的WdatePicker.css文件來修改樣式

 

2. 支持的瀏覽器

IE 6.0+ , Firefox 2.0+ , Chrome, Opera 9.5+ , Safari 3.0+

注意:IE 8/9/10/11是完美支持的,若是你在IE上使用遇到問題,請與我取得聯繫,務必附上能再現你的問題的純HTML代碼包

 

二. 功能及示例

1. 常規功能

（1）支持多種調用模式

除了支持常規在input單擊或得到焦點調用外,還支持使用其餘的元素如:

等觸發WdatePicker函數來調用彈出日期框

（2）下拉,輸入,導航選擇日期

年月時分秒輸入框都具有如下三種特性

a. 經過導航圖標選擇

b. 直接使用鍵盤輸入數字

c. 直接從彈出的下拉框中選擇

另:年份輸入框有智能提示功能,當用戶連續點擊同一個導航按鈕5次時,會自動彈出年份下拉框

（3）支持周顯示（控制參數——isShowWeek：true/false）

能夠經過配置isShowWeek屬性決定是否限制周,而且在返回日期的時候還能夠經過自帶的自定義事件和API函數返回選擇的周

（4）只讀開關,高亮週末功能

設置readOnly屬性 true 或 false 可指定日期input框是否只讀

設置highLineWeekDay屬性 ture 或 false 可指定是否高亮週末

（5）操做按鈕自定義

清空按鈕和今天按鈕,能夠根據須要進行自定義,它們分別對應 isShowClear 和 isShowToday 默認值都是true

（6）自動選擇顯示位置

當控件處在頁面邊界時,它會自動選擇顯示的位置,因此沒有必要擔憂彈出框會被頁面邊界遮住的問題了.

（7）自定義彈出位置

當控件處在頁面邊界時,它會自動選擇顯示的位置.此外你還可使用position參數對彈出位置作調整.

（8）自定義星期的第一天(控制參數——firstDayOfWeek)

各個國家的習慣不一樣,有些喜歡以星期日做爲第一天,有些以星期一做爲第一天.

相關屬性:firstDayOfWeek: 可設置 0 - 6 的任意一個數字,0:星期日 1:星期一 以此類推

 

2. 特點功能

（1）平面顯示（控制參數——eCont）

日期控件支持平面顯示功能,只要設置一下eCont屬性就能夠把它看成日從來使用了,無需觸發條件,直接顯示在頁面上

（2）支持多種容器

除了能夠將值返回給input之外,還能夠經過配置el屬性將值返回給其餘的元素(如:textarea,div,span)等,帶有innerHTML屬性的HTML元素

（3）起始日期功能（控制參數——startDate，alwaysUseStartDate）

注意:日期格式必須與 realDateFmt 和 realTimeFmt 一致而不是與 dateFmt 一致

有時在項目中須要選擇生日之類的日期,而默認點開始日期都是當前日期,致使年份選擇很是麻煩,你能夠經過起始日期功能加上配置alwaysUseStartDate屬性輕鬆解決此類問題

（4）自定義格式（控制參數——skin，dateFmt，vel）

yMdHmswW分別表明年月日時分秒星期周,你能夠任意組合這些元素來自定義你個性化的日期格式.

格式	說明
y	將年份表示爲最多兩位數字。若是年份多於兩位數，則結果中僅顯示兩位低位數。
yy	同上，若是小於兩位數，前面補零。
yyy	將年份表示爲三位數字。若是少於三位數，前面補零。
yyyy	將年份表示爲四位數字。若是少於四位數，前面補零。
M	將月份表示爲從 1 至 12 的數字
MM	同上，若是小於兩位數，前面補零。
MMM	返回月份的縮寫 一月 至 十二月 (英文狀態下 Jan to Dec) 。
MMMM	返回月份的全稱 一月 至 十二月 (英文狀態下 January to December) 。
d	將月中日期表示爲從 1 至 31 的數字。
dd	同上，若是小於兩位數，前面補零。
H	將小時表示爲從 0 至 23 的數字。
HH	同上，若是小於兩位數，前面補零。
m	將分鐘表示爲從 0 至 59 的數字。
mm	同上，若是小於兩位數，前面補零。
s	將秒錶示爲從 0 至 59 的數字。
ss	同上，若是小於兩位數，前面補零。
w	返回星期對應的數字 0 (星期天) - 6 (星期六) 。
D	返回星期的縮寫 一 至 六 (英文狀態下 Sun to Sat) 。
DD	返回星期的全稱 星期一 至 星期六 (英文狀態下 Sunday to Saturday) 。
W	返回周對應的數字 (1 - 53) 。
WW	同上，若是小於兩位數，前面補零 (01 - 53) 。

 示例

格式字符串	值
yyyy-MM-dd HH:mm:ss	2008-03-12 19:20:00
yy年M月	08年3月
yyyyMMdd	20080312
今天是:yyyy年M年d HH時mm分	今天是:2008年3月12日 19時20分
H:m:s	19:20:0
y年	8年
MMMM d, yyyy	三月 12, 2008

（5）雙月日曆功能（控制參數——doubleCalendar：true/false）

能夠同時彈出兩個月的日曆

 

（6）自動糾錯功能

糾錯處理可設置爲3種模式:提示(默認)、自動糾錯、標記,當日期框中的值不符合格式時,系統會嘗試自動修復,若是修復失敗會根據您設置的糾錯處理模式進行處理,錯誤判斷功能很是智能它能夠保證用戶輸入的值是一個合法的值

（7）跨無限級框架顯示

不管你把日期控件放在哪裏,你都不須要擔憂會被外層的iframe所遮擋進而影響客戶體驗,由於My97日期控件是能夠跨無限級框架顯示的

 

（8）民國年日曆和其餘特殊日曆

當年份格式設置爲yyy格式時,利用年份差量屬性yearOffset(默認值1911民國元年),可實現民國年日曆和其餘特殊日曆

（9）編輯功能

當日期框裏面有值時,修改完某個屬性後,只要點擊這個按鈕就能夠實現時間和日期的編輯

（10）爲編程帶來方便

若是el的值是this,可省略,即全部的el:this均可以不寫

日期框設置爲disabled時,禁止更改日期(不彈出選擇框)

若是沒有定義onpicked事件,自動觸發文本框的onchange事件

若是沒有定義oncleared事件,清空時,自動觸發onchange事件

（11）其餘屬性

設置readOnly屬性,可指定日期框是否只讀

設置highLineWeekDay屬性,可指定是否高亮週末

設置isShowOthers屬性,可指定是否顯示其餘月的日期

加上class="Wdate"就會在選擇框右邊出現日期圖標

 

3. 多語言和自定義皮膚

（1）多語言支持

經過lang屬性,能夠爲每一個日期控件單獨配置語言,固然也能夠經過WdatePicker.js配置全局的語言

語言列表和語言安裝說明詳見語言配置

（2）自定義和動態切換皮膚 馬上轉到皮膚中心

經過skin屬性,能夠爲每一個日期控件單獨配置皮膚,固然也能夠經過WdatePicker.js配置全局的皮膚

皮膚列表和皮膚安裝說明詳見皮膚配置

 

4. 日期範圍限制

（1）靜態限制（控制參數——minDate/maxDate）

注意:日期格式必須與 realDateFmt 和 realTimeFmt 一致而不是與 dateFmt 一致

你能夠給經過配置minDate(最小日期),maxDate(最大日期)爲靜態日期值,來限定日期的範圍

 

（2）動態限制

注意:日期格式必須與 realDateFmt 和 realTimeFmt 一致而不是與 dateFmt 一致

你能夠經過系統給出的動態變量,如%y(當前年),%M(當前月)等來限度日期範圍,你還能夠經過{}進行表達式運算,如:{%d+1}:表示明天

 

動態變量表

格式	說明
%y	當前年
%M	當前月
%d	當前日
%ld	本月最後一天
%H	當前時
%m	當前分
%s	當前秒
{}	運算表達式,如:{%d+1}:表示明天
#F{}	{}之間是函數可寫自定義JS代碼

（3）腳本自定義限制

注意:日期格式必須與 realDateFmt 和 realTimeFmt 一致而不是與 dateFmt 一致

系統提供了$dp.$D和$dp.$DV這兩個API來輔助你進行日期運算,此外你還能夠經過在 #F{} 中填入你自定義的腳本,作任何你想作的日期限制

 

（4）無效天（控制參數——disabledDays）

可使用此功能禁用週日至週六所對應的日期,相關屬性:disabledDays (0至6 分別表明 週日至週六)

 

（5）無效日期

注意:日期格式必須與 realDateFmt 和 realTimeFmt 一致而不是與 dateFmt 一致

可使用此功能禁用,所指定的一個或多個日期,只要你熟悉正則表達式,你能夠盡情發揮

用法(正則匹配):

若是你熟悉正則表達式,會很容易理解下面的匹配用法

若是不熟悉,能夠參考下面的經常使用示例

['2008-02-01','2008-02-29'] 表示禁用 2008-02-01 和 2008-02-29

['2008-..-01','2008-02-29'] 表示禁用 2008-全部月份-01 和 2008-02-29

['200[0-8]]-02-01','2008-02-29'] 表示禁用 [2000至2008]-02-01 和 2008-02-29

['^2006'] 表示禁用 2006年的全部日期

此外,您還可使用 %y %M %d %H %m %s 等變量, 用法同動態日期限制 注意:%ld不能使用

['....-..-01','%y-%M-%d'] 表示禁用 全部年份和全部月份的第一天和今天

['%y-%M-{%d-1}','%y-%M-{%d+1}'] 表示禁用 昨天和明天

固然,除了能夠限制日期之外,您還能夠限制時間

['....-..-.. 10\:00\:00'] 表示禁用 天天10點 (注意 : 須要 使用 \: )

再也不多舉例了,盡情發揮你的正則才能吧!

（6）有效日期（控制參數——opposite）

使用無效日期能夠很方便的禁用不可用的日期,可是在只須要啓用少部分日期的狀況下,有效日期的功能就很是適合了.

關鍵屬性: opposite 默認爲false, 爲true時,無效日期變成有效日期,該屬性對無效天,特殊天不起做用

 

（7）特殊天和特殊日期（控制參數——specialDays、specialDates）

特殊天和特殊日期的用法跟徹底無效天和無效日期徹底相同,可是opposite屬性對其無效

 

關鍵屬性:

specialDays (0至6 分別表明 週日至週六) 用法同無效天

specialDates 用法同無效日期,可是對時分秒無效

 

5. 自定義事件

（1）自定義事件

若是你須要作一些附加的操做,你也沒必要擔憂,日期控件自帶的自定義事件能夠知足你的需求.此外,你還能夠在自定義事件中調用提供的API庫來作更多的運算和擴展,絕對能夠經過不多的代碼知足你及其個性化的需求.

注意下面幾個重要的指針,將對你的編程帶來不少便利

this: 指向文本框

dp: 指向$dp

dp.cal: 指向日期控件對象

注意:函數原型必須使用相似 function(dp){} 的模式,這樣子,在函數內部纔可使用dp

（2）onpicking 和 onpicked 事件

（3）onclearing 和 oncleared 事件

（4）年月日時分秒的 changing和changed

年月日時分秒都有對應的changing和changed事件,分別是:

ychanging ychanged

Mchanging Mchanged

dchanging dchanged

Hchanging Hchanged

mchanging mchanged

schanging schanged

 

6. 快速選擇功能（控制參數——qsEnabled、quickSel）

此功能容許指定5個最經常使用的日期,能夠方便用戶選擇,若是不指定,系統將自動生成

相關屬性:

qsEnabled 是否啓用快速選擇功能, 注意:若是日期格式裏不包含 d(天) 這個元素時,快速選擇將一直顯示,不受此屬性控制

quickSel 快速選擇數據,能夠傳入5個快速選擇日期,日期格式同min/maxDate

注意:

日期格式必須與 realDateFmt realTimeFmt 相匹配

除了使用靜態的日期值之外,還可使用動態參數(如:%y,%M分別表示當前年和月)

 

三. 配置說明

1. 屬性配置

（1）屬性表

屬性	類型	默認值	說明
靜態屬性:只能在WdatePicker.js中配置,通常狀況下,不建議您修改靜態屬性的值
$wdate	bool	true	是否自動引入Wdate類 設置爲true時,可直接在引入WdatePicker.js的頁面裏使用 class="Wdate"  Wdate可在skin目錄下的WdatePicker.css文件中定義 建議使用默認值
$dpPath	string	''	是否顯示指定程序包的絕對位置,通常狀況下爲空便可(程序自動建立),該屬性是爲防止極其少數的狀況下程序建立出錯而設置的 設置方法: 若是,程序包所在http中的地址爲 http://localhost/proName/My97DatePicker/ 則 $dpPath = '/proName/My97DatePicker/'; 建議使用默認值
$crossFrame	bool	true	是否跨框架,通常設置爲true便可,遇到跨域錯誤時能夠將此功能關閉
可配置屬性:能夠在WdatePicker方法是配置
el	Element 或 String	null	指定一個控件或控件的ID,必須具備value或innerHTML屬性(如input,textarea,span,div,p等標籤均可以),用戶存儲日期顯示值(也就是dateFmt格式化後的值)
vel	Element 或 String	null	指定一個控件或控件的ID,必須具備value屬性(如input),用於存儲真實值(也就是realDateFmt和realTimeFmt格式化後的值)
doubleCalendar	bool	false	是不是雙月模式,若是該屬性爲true,則彈出同時顯示2個月的日期框
enableKeyboard	bool	true	鍵盤控制開關
enableInputMask	bool	true	文本框輸入啓用掩碼開關
autoUpdateOnChanged	bool	null	在修改年月日時分秒等元素時,自動更新到el,默認是關閉的(即:須要點擊肯定或點擊日期才更新) 爲false時 不自動更新 爲true時 自動更新 爲null時(默認值) 若是有日元素且不隱藏肯定按鈕時 爲false,其餘狀況爲true
weekMethod	string	ISO8601	周算法不一樣的地方有一些差別 常見算法有兩種 1. ISO8601:規定第一個星期四爲第一週,默認值 2. MSExcel:1月1日所在的周 相關連接:http://en.wikipedia.org/wiki/ISO_week_date
position	object	{}	日期選擇框顯示位置 注意:座標單位是px,是相對當前框架座標(不受滾動條影響),默認狀況下系統根據頁面大小自動選擇 如: {left:100,top:50}表示固定座標[100,50] {top:50}表示橫座標自動生成,縱座標指定爲 50 {left:100}表示縱座標自動生成,橫座標指定爲 100 請參考示例
lang	string	'auto'	當值爲'auto'時 自動根據客戶端瀏覽器的語言自動選擇語言 當值爲 其餘 時 從langList中選擇對應的語言  你能夠參考語言配置
skin	string	'default'	皮膚名稱 默認自帶 default和whyGreen兩個皮膚 另外若是你的css夠強的話,能夠本身作皮膚 你能夠參考皮膚配置
dateFmt	string	'yyyy-MM-dd'	日期顯示格式 你能夠參考自定義格式
realDateFmt	string	'yyyy-MM-dd'	計算機可識別的,真正的日期格式 無效日期設置(disabledDates),最大日期(maxDate),最小日期(minDate)以及快速日期都必須與它們相匹配 建議使用默認值
realTimeFmt	string	'HH:mm:ss'
realFullFmt	string	'%Date %Time'
minDate	string	'1900-01-01 00:00:00'	最小日期(注意要與上面的real日期相匹配)
maxDate	string	'2099-12-31 23:59:59'	最大日期(注意要與上面的real日期相匹配)
startDate	string	''	起始日期,既點擊日期框時顯示的起始日期 爲空時,使用今天做爲起始日期(默認值) 不然使用傳入的日期做爲起始日期(注意要與上面的real日期相匹配) 你能夠參考起始日期示例
firstDayOfWeek	int	0	周的第一天 0表示星期日 1表示星期一
isShowWeek	bool	false	是否顯示周 你能夠參考周顯示示例
highLineWeekDay	bool	true	是否高亮顯示 週六 週日
isShowClear	bool	true	是否顯示清空按鈕
isShowOK	bool	true	是否顯示肯定按鈕
isShowToday	bool	true	是否顯示今天按鈕
isShowOthers	bool	true	爲true時,第一行空白處顯示上月的日期，末行空白處顯示下月的日期,不然不顯示
readOnly	bool	false	是否只讀
errDealMode	int	0	糾錯模式設置 可設置3中模式 0 - 提示 1 - 自動糾錯 2 - 標記
autoPickDate	bool	null	爲false時 點日期的時候不自動輸入,而是要經過肯定才能輸入 爲true時 即點擊日期便可返回日期值 爲null時(推薦使用) 若是有時間置爲false 不然置爲true
hmsMenuCfg	Object	{ H: [1, 6], m: [5, 6], s: [15, 4] }	4.8beta4新增   使用hmsMenuCfg屬性能夠實現時分秒菜單的自定義 時分秒自定義 H m s 分別表明時分秒 第一個參數表示步進,1表示0,1,2,3... 2表示0,2,4... 15表示0,15,30... 第二個參數表示每行顯示值的數量 默認H [1, 6] 步進1 每行顯示6個 共4行 默認m [5, 6] 步進5 每行顯示6個 共2行 默認s [15, 4] 步進15 每行顯示4個 共1行
qsEnabled	bool	true	是否啓用快速選擇功能 注意:當日期格式中沒有d這個元素時(如yyyy-MM或HH:mm:ss這樣的格式時),該屬性永遠爲true
autoShowQS	bool	false	是否默認顯示快速選擇
quickSel	Array	null	快速選擇數據,能夠傳入5個快速選擇日期 注意:日期格式必須與 realDateFmt realTimeFmt realFullFmt 相匹配 你能夠參考快速選擇示例
disabledDays	Array	null	可使用此功能禁用週日至週六所對應的日期 0至6 分別表明 週日至週六 你能夠參考無效天示例
disabledDates	Array	null	可使用此功能禁用所指定的一個或多個日期 你能夠參考無效日期示例
opposite	bool	false	默認爲false, 爲true時,無效日期變成有效日期  注意:該屬性對無效天特殊天不起做用 你能夠參考有效日期示例
specialDates	Array	null	特殊日期,對指定的日期進行高亮顯示 你能夠參考特殊天與特殊日期示例
specialDays	Array	null	特殊天,使用此功能禁用週日至週六所對應的日期進行高亮顯示 0至6 分別表明 週日至週六 你能夠參考特殊天與特殊日期示例
onpicking	function	null	此四個參數爲事件參數 你能夠參考自定義事件示例
onpicked	function	null
onclearing	function	null
oncleared	function	null
ychanging ychanged  Mchanging Mchanged dchanging dchanged Hchanging Hchanged mchanging mchanged schanging schanged	function	null	y M d H m s 分別表示年月日時分秒 changing 事件發生在屬性改變以前 changed 事件發生在屬性改變以後 你能夠參考示例5-4-1

（2）配置全局默認值

經過配置WdatePicker.js的屬性能夠避免每次調用都傳入配置值,爲變成帶來不少方便.

在默認狀況下My97爲每一個屬性都配置了默認值,這些默認值均可以在WdatePicker.js中修改的

你能夠根據你我的的喜愛更改這些值

好比你比較不喜歡默認的皮膚default 而更喜歡 whyGreen 這個皮膚,

你能夠直接在WdatePicker.js把skin值改成 whyGreen

這樣,你就沒必要每次調用控件的時候都傳入 skin:'whyGreen' 了

你學會了嗎?

（3）配置單個控件

在控件裏面你可使用 onfocus 或 onclick 事件來調用WdatePicker函數來觸發日期控件

WdatePicker({})其中{}中的內容都是隻對當前實例有效,你能夠任意配置屬性表裏有的全部屬性

你能夠隨意的組合這些屬性,達到你的需求

My97日期控件在這方面是作得很是靈活的.

（4）多套配置快速切換

您能夠設置多個WdatePicker.js文件,如 cn_WdatePicker.js,en_WdatePicker.js,simple_WdatePicker.js等

在不一樣的頁面引入不一樣的 WdatePicker.js 達到配置快速切換的目的.

注意:文件必須以 _WdatePicker.js(大小寫不限制) 爲後綴,形如 _WdatePicker.js

 

2. 語言配置

（1）語言列表

My97DatePicker目錄下有個config.js(4.8之後在WdatePicker.js中),裏面有段代碼:

  var langList =
  [
   {name:'en', charset:'UTF-8'},
   {name:'zh-cn', charset:'gb2312'},
   {name:'zh-tw', charset:'GBK'}
  ];

這就是語言列表,每一個項有name和charset兩個屬性.

name 表示語言的名稱(必須與瀏覽器的語言字符串命名相同),在配置的時候,lang屬性只能是配置列表裏面已有的項,不然將自動返回第一項

charset 表示對應語言目錄下的js文件所對應的編碼格式

（2）語言安裝說明

分兩步輕鬆實現:

a.將語言文件拷貝到 lang 目錄

b.打開 config.js 配置語言列表

 

3. 皮膚配置

 （1）皮膚列表

My97DatePicker目錄下有個config.js(4.8之後在WdatePicker.js中),裏面有段代碼:

  var skinList =

  [
   {name:'default', charset:'gb2312'},
   {name:'whyGreen', charset:'gb2312'},
   {name:'blue', charset:'gb2312'},
   {name:'simple', charset:'gb2312'}
  ];

這就是皮膚列表,每一個項有name和charset兩個屬性.

name 表示皮膚的名稱,在配置的時候,skin屬性只能是配置列表裏面已有的項,不然將自動返回第一項

charset 表示對應皮膚目錄下的css文件:datepicker.css所對應的編碼格式

（2）皮膚安裝說明

分兩步輕鬆實現:

a.將皮膚文件包拷貝到 skin 目錄

b.打開 config.js 配置皮膚列表

注意:安裝過多的皮膚會影響性能,通常只安裝本身使用的皮膚,3個如下比較適宜

 

四. 如何使用

1. 在使用該日期控件的文件中加入JS庫(僅這一個文件便可,其餘文件會自動引入,請勿刪除或更名), 代碼以下 <script language="javascript" type="text/javascript" src="datepicker/WdatePicker.js"></script>

注:src="datepicker/WdatePicker.js" 請根據你的實際狀況改變路徑

 

2. 加上主調函數 WdatePicker

關於 WdatePicker 的用法:

若是您是新手,對js還不是很瞭解的話必定要多看看這份文檔

基本上每個演示的示例下面都有相關代碼,而且 關鍵屬性用藍字標出,關鍵值用紅字標出 應該很容易看明白

若是您有必定的水準

但願能從頭至尾把功能介紹好好看一遍,這樣大部分功能你都會用了

若是您是高手

建議您通讀配置說明和內置函數

 

五. 內置函數和屬性

函數名	返回值類型	做用域	參數	描述
$dp.show	void	全局	無	顯示日期選擇框
$dp.hide	void	全局	無	隱藏日期選擇框
$dp.unbind (4.8beta4新增)	void	全局	el [string/object]:取消綁定的對象,可傳入dom對象或者是對象的ID	讓傳入的對象取消日期控件綁定
$dp.$D	String	全局	id [string]: 對象的ID  arg [object]: 日期差量,能夠設置成 {y:[值],M:[值],d:[值],H:[值],m:[值],s:[值]} 屬性 y,M,d,H,m,s 分別表明 年月日時分秒 {M:3,d:7} 表示 3個月零7天 {d:1,H:1} 表示1天多1小時	將id對應的日期框中的日期字符串,加上定義的日期差量,返回使用real格式化後的日期串 參考 示例 4-3-2
$dp.$DV	String	全局	v [string]: 日期字符串 arg [object]: 同上例的arg	將傳入的日期字符串,加上定義的日期差量,返回使用real格式化後的日期串 參考 示例 4-3-3
如下函數只在事件自定義函數中有效
$dp.cal.getP	String	事件function	p [string]: 屬性名稱 yMdHmswWD分別表明年,月,日,時,分,秒,星期(0-6),周(1-52),星期(一-六)  f [string]: format 格式字符串 設置方法參考 1.4 自定義格式	返回所指定屬性被格式字符串格式化後的值[單屬性],在changing,picking,clearing事件中返回選擇前的值 參考 示例 1-2-2
$dp.cal.getDateStr	String	事件function	f [string]: 格式字符串,爲空時使用dateFmt	返回所指定屬性被格式字符串格式化後的值[整個值],在changing,picking,clearing事件中返回選擇前的值
$dp.cal.getNewP	String	事件function	用法同$dp.cal.getP	返回所指定屬性被格式字符串格式化後的值[單屬性],在changing,picking,clearing事件中返回選擇後的值
$dp.cal.getNewDateStr	String	事件function	用法同$dp.cal.getDateStr	返回所指定屬性被格式字符串格式化後的值[整個值],在changing,picking,clearing事件中返回選擇後的值

 

屬性名	返回值類型	做用域	參數	描述
$dp.cal.date	object	事件function	$dp.cal.date.y:返回 年 $dp.cal.date.M:返回 月 $dp.cal.date.d:返回 日 $dp.cal.date.H:返回 時 $dp.cal.date.m:返回 分 $dp.cal.date.s:返回 秒	在changing,picking,clearing事件中返回選擇前的日期對象
$dp.cal.newdate	object	事件function	用法同$dp.cal.date	在changing,picking,clearing事件中返回選擇後的日期對象

 

分