【功能說明】

用途：使用於Web網頁中，此元件是一個日期選擇的元件，可以開窗選擇某一個日期並傳回，如用於綁定資料庫欄位時，可以為DateTime類型，也可以為VarChar(8)類型(格式一律為YYYYMMDD)。

【元件屬性】

(ID)(名稱)(string)

元件名稱，用於識別該元件。

 

DateFormat(日期格式)(enum)

所顯示日期的格式，可設定為 None(不設定)，ShortDate(短日期，沒有時間)，LongDate(長日期，包含時間)。

DateString(日期字串)(string)

當綁定資料庫的欄位為VarChar(8)類型時，其日期內容的字串會存在這個屬性當中。

Text(內容)(string)

當綁定資料庫的欄位為DateTime類型時，其日期內容的字串會存在這個屬性當中。

DateTimeType(日期型態)(enum)

專門用來設定日期的欄位型態，可設定為DateTime與VarChar型態，Varchar的長度一定必須為8。

UseButtonImage(圖示按鈕)(bool)

指示WebDateTimePicker的按鈕外觀(true為Image,false為普通button)。

ButtonCaption(按鈕抬頭)(string)

設置當WebDateTimePicker的按鈕外觀為button時，其按鈕上的文字抬頭。

ButtonImageUrl(按鈕圖示)(string)

設置當WebDateTimePicker的按鈕外觀為Image時，按鈕上的圖案的Url位址。

ReadOnly(唯讀)(bool)

設置WebDateTimePicker是否為唯讀，如果為True，則就不會有右邊的選單小Button。

Caption(抬頭)(string)

打開此WebDateTimePicker視窗上面的抬頭文字內容。

CheckData(日期檢查)(bool)

來控制是否要檢查日期格式，預設為true。

 Localize ( 自訂時間格式 )(bool)

 顯示時間格式時，可根據 Client 的系統判斷顯示時間的格式，當 Client 為          繁體系統以民國年顯示。

 

 LocalizeForROC( 民國年格式 )(bool)

 設定顯示時間格式否有以民國年， True 會固定為民國年的格式。

 

【其他說明】

1. 如果此元件與資料源欄位綁定連結時，如果欄位的值類型為DateTime，請綁定Text屬性，但如果欄位的值類型為VarChar(8)者，則須綁定DateString屬性。

2.如果你在 WebDateTimePicker 輸入時，發現日期為 12/31/9999 年或 12/31/2999 年時，就是代表該日期是不存在或是空的日期，如果不予理會，系統還是會當做空值來處理，除非你用 WebValidate 來禁止空值。

3.當 WebDateTime.DateTimeType 設為 Varchar 時 , 會自動將 DateFormat 設為 Short 。

4.日期格式在綁定時，如果要自行控制，可以使用 Custom Data Binding 方式，如下格式：

Bind("OrderDate", "{0:yy-MM-dd}") ，代表格式為 98-05-28 ，其中各字元格式的代表意義如下：

M ： 月份，一個 Byte 到兩個 Bytes ，前面不補 ’0’ ， 1-12 。

MM ：月份，固定兩個 Bytes ，前面補 ’0’ ， 01-12 。

MMM ：月份，英文三個字母的縮寫， Jan-Dec 。

MMMM ：月份，英文月份的全名， January-December 。

d ：日期，一個 Byte 到兩個 Bytes ，前面不補 ’0’ ， 1-31 。

dd ：日期，固定兩個 Bytes ，前面補 ’0’ ， 01-31 。

ddd ：星期，使用星期的英文三個字母的縮寫， Sun-Sat 。

dddd ：星期，英文星期的全名， Sunday-Saturday 。

y ：年度，一個 Byte 到兩個 Bytes ，最多只取 2 位，前面不補 ’0’ ， 0-99 。

yy ：年度，固定兩個 Bytes ，前面補 ’0’ ， 00-99 。

yyyy ：年度，固定四個 Bytes ， 1900-9999 。

h ：小時， 12 小時制，一個 Byte 到兩個 Bytes ，前面不補 ’0’ ， 0-12 。

hh ：小時， 12 小時制，固定兩個 Bytes ，前面補 ’0’ ， 00-12 。

H ：小時， 24 小時制，一個 Byte 到兩個 Bytes ，前面不補 ’0’ ， 0-23 。

HH ：小時， 24 小時制，固定兩個 Bytes ，前面補 ’0’ ， 00-23 。

m ：分鐘，一個 Byte 到兩個 Bytes ，最多只取 2 位，前面不補 ’0’ ， 0-59 。

mm ：分鐘，固定兩個 Bytes ，前面補 ’0’ ， 00-59 。

s ：秒鐘，一個 Byte 到兩個 Bytes ，最多只取 2 位，前面不補 ’0’ ， 0-59 。

ss ：秒鐘，固定兩個 Bytes ，前面補 ’0’ ， 00-59 。

t ：上下午， 12 小時制時使用，顯示 ’A’ 或 ’P’ 。

tt ：上下午， 12 小時制時使用，顯示 ’AM’ 或 ’PM’ 。