1.1 版本
|
報表伺服器版本
|
功能變更
|
|
11.0
|
--
|
11.0.5
|
詳情見：2.1.1節、2.1.2 節表格中的格式屬性
|
|
11.0.11
|
當月日期所在的下拉選項列表中，支援選擇非本月日期，詳情見 1.4 節注意事項
|
|
11.0.30
|
標籤名稱支援使用公式，詳情參見 2.1.2 節
|
1.2 應用場景
1.2.1 填報元件
填報報表中，選擇一個日期填入。如下圖所示：
1.2.2 參數元件
報表中新增日期查詢元件，可以查詢指定日期區間內的報表資料。如下圖所示：
1.3 如何新增
1.3.1 填報元件
被菜儲存格後，點選右側屬性面板的「
元件設定
」，選擇元件處下拉選擇「
日期元件
」，如下圖所示：
1.3.2 參數元件
將參數面板元件工具欄中的「
日期元件
」拖入到參數面板中，如下圖所示：
1.4 注意事項
1）國外普遍認為一個星期從週日開始，而國內普遍認為一個星期從週一開始，為了滿足國內外使用者使用習慣，「
日期元件
」 提供了星期切換功能。
瀏覽器使用「
日期元件
」的時候，點選週一即可將週一排在一個星期的第一天，點選週日將週日排在一個星期的第一天。如下圖所示：
「
日期元件
」中日期所屬的週數也會隨對應選擇的星期模式變換。
2）日期元件如果設定了聯動，則在日期選擇介面的任何操作都會即時觸發聯動效果，比如翻頁，切換年月等。所以當單次聯動速度較慢的情況下，如果頻繁點選切換，可能會造成頁面卡死。
3）「
日期元件
」下拉選項，非本月日期選項將表現為灰色，點選不能選中該日期。
注：11.0.11 及以後，下拉選項中非本月日期選項雖置灰，但支援選擇，如下圖所示：
新增「
日期元件
」後，可在右下方設定日期元件的屬性。如下圖所示：
各屬性設定項的詳細介紹如下：
注1：「日期元件」在填報應用時，可透過在儲存格中新增日期值的方式設定預設值，如輸入 2021-06-21。
注2：給「
日期元件
」指派的時候，比如預設值、開始日期、結束日期等，為準確識別，建議都使用 yyyy-MM-dd 的日期格式。
|
分類
|
設定項
|
詳細介紹
|
|
基本
|
元件名稱
|
元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為無。
|
|
可 用
|
元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。
|
|
可 見
|
元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。
|
|
進階
|
格 式
|
日期元件的支援的輸入格式，日期型和時間型，預設為日期型。
1）日期型：使用者可以在年月日的範圍內定義查詢日期格式。
2）時間型：使用者可以在年月日時分秒範圍內定義查詢日期格式。
使用者可以透過修改日期格式來變換日期元件的顯示樣式，如修改為"yyyy-MM"來讓元件顯示為年月樣式
注：11.0.5 及之後支援透過設定"yyyy"格式來顯示成年份元件。
使用者可以在格式下拉框中選擇格式，也可以直接填寫格式，當填寫的格式不支援時，範例框中會紅字提醒使用者：
|
|
開始日期
|
元件支援選擇的日期範圍的開始日期，即可以選擇的最小日期值。設定後，不在範圍內的資料將變成灰色不可選取狀態。
有 3 種類型，預設為無
1）無：不做限制
2）日期：可以選擇一個特定的日期
3）公式：直接寫入公式值，如 A1 儲存格為一個日期值，這裏寫 A1，即可引用這個日期值
注：當日期元件有預設值時，設定的開始日期不生效，必須要重新選擇才會生效。
元件預設值生效邏輯請參見：
元件預設值
|
|
結束日期
|
元件支援選擇的日期範圍的結束日期，即可以選擇的最大日期值。設定後，不在範圍內的資料將變成灰色不可選取狀態，支援的類型和「開始日期」相同。
|
|
水 印
|
填報時元件內顯示的淺灰色水印文字，手動輸入，以提示使用者需要輸入資訊，點選元件編輯區域後消失，預設為空。
|
|
回傳值類型
|
選擇後，回傳值的格式，分為日期和字串兩種，需要跟資料庫表中日期欄位的類型匹配。
1）日期：回傳值類型是日期型
2）字串：回傳值類型為字串
|
|
校驗
|
允許為空
|
是否允許元件不選擇項，勾選後，允許元件不選擇；不勾選，填報校驗和提交時會提示，預設勾選。
|
|
錯誤提示
|
不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空
|
|
允許直接編輯
|
是否允許使用者直接輸入值，勾選後，使用者可以直接輸入值，預設勾選。
注：此功能不支援行動端。
|
新增「
日期元件
」後，可在右下方設定日期元件的屬性。如下圖所示：
各屬性設定項的詳細介紹如下：
注：給「日期元件」指派的時候，比如預設值、開始日期、結束日期等，為準確識別，建議都使用 yyyy-MM-dd 的日期格式。
分類
|
設定項
|
詳細介紹
|
|
基本
|
元件名稱
|
元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為 dateEditor# 。
|
|
可 用
|
元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。
|
|
可 見
|
元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。
|
|
進階
|
標籤名稱
|
元件的標籤屬性是用在行動端的，行動端不支援參數面板上的「標籤元件」，識別的是普通元件的「標籤名稱」屬性，所以行動端可以用元件的標籤名稱來實現標籤 。
FineReport 11.0.30 及以上版本，標籤名稱支援使用公式。編輯框內輸入公式正文（等號開頭），自動計算公式結果作為最終標籤名稱。
注：使用 i18n 函式實現標籤名稱根據語言顯示時，多語言插件需更新至 V2.2.2 版本。若範本中使用的 key (範本內或平台內的 key )更新，需手動重新整理範本才可生效。
|
|
控 件 值
|
元件初始化時的預設值，支援日期、公式、欄位，預設當天日期。
1）日期：日期型，可以選擇一個日期，如下：
2）公式：設計器支援的公式，例如： A1 儲存格為一個日期值，這裏寫 A1。
如果希望日期元件預設值為空，則可以用公式輸入一個空字串：'' 來實現。
3）欄位：資料集欄位，資料集包括範本資料集和伺服器資料集。例如：資料集 ds1 的日期欄位。
|
|
格式
|
日期元件的支援的輸入格式，日期型和時間型，預設為日期型。
使用者可以透過修改日期格式來變換日期元件的顯示樣式，如修改為"yyyy-MM"來讓元件顯示為年月樣式
注：11.0.5 及之後支援透過設定"yyyy"格式來顯示成年份元件。
使用者可以在格式下拉框中選擇格式，也可以直接填寫格式，當填寫的格式不支援時，範例框中會紅字提醒使用者：
1）日期型：使用者可以在
年月日
的範圍內定義查詢日期格式。
2）時間型：使用者可以在
年月日時分秒
範圍內定義查詢日期格式。
|
|
開始日期
|
元件支援選擇的日期範圍的開始日期，即可以選擇的最小日期值。設定後，不在範圍內的資料將變成灰色不可選取狀態。
有 3 種類型，預設為無
1）無：不做限制
2）日期：可以選擇一個特定的日期
3）公式：直接寫入公式值，如 A1 儲存格為一個日期值，這裏寫 A1，即可引用這個日期值
|
|
結束日期
|
元件支援選擇的日期範圍的結束日期，即可以選擇的最大日期值。設定後，不在範圍內的資料將變成灰色不可選取狀態，支援的類型和「開始日期」相同。
|
水印
|
填報時元件內顯示的淺灰色水印文字，手動輸入，以提示使用者需要輸入資訊，點選元件編輯區域後消失，預設為空。
|
|
字體大小
|
被選中的，顯示在元件框中日期的字體大小，預設為 12 。
注1：下拉選項中的日期文字大小不隨此處的字體大小變化。
注2：此功能不支援行動端。
|
|
回傳值類型
|
選擇後，回傳值的格式，分為日期、字串。
1）日期：回傳值類型是日期類型，和資料庫欄位相關。
2）字串：回傳值類型是字串，和資料庫欄位相關。
|
|
校驗
|
允許為空
|
是否允許元件不選擇項，勾選後，允許元件不選擇；不勾選，填報校驗和提交時會提示，預設勾選。
|
|
錯誤提示
|
不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空
|
|
允許直接編輯
|
是否允許使用者直接輸入值，勾選後，使用者可以直接輸入值，預設勾選。
注：此功能不支援行動端。
|
|
坐標.尺寸
|
元件位置
|
元件在參數面板中的位置，透過橫縱座標調整，座標會根據元件在參數面板中的位置自動顯示。
|
|
元件大小
|
元件的大小，透過寬度、高度調整，若透過拖曳調整，高寬度也隨着自動調整。
|
2.2 事件
事件設定介面可以為元件新增事件實現某些效果，「
日期元件
」支援的事件有初始化後、編輯後、編輯結束。如下圖所示：
選擇一種事件類型後，即可新增事件內容，「
日期元件
」支援的事件回应方式有 JavaScript 腳本、提交入庫、傳送郵件、匯出事件、行動端彈窗。如下圖所示：
選擇對應的事件回应方式新增即可，不同回应方式差別可參考：
事件的回应方式
2.3 行動端
行動端無可配置項。
