WebDateTimePicker

 

【功能說明】

用途：使用於 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’ 。