反饋已提交

網絡繁忙

日期元件

1. 概述

1.1 版本

報表伺服器版本功能變更
11.0--
11.0.5
  • 支援年份元件,將原有「年份選擇元件」合併到「日期元件」

  • 當使用者輸入元件格式不支援時,提醒使用者不支援此種用法,

詳情見:2.1.1節、2.1.2 節表格中的格式屬性

11.0.11當月日期所在的下拉選項列表中,支援選擇非本月日期,詳情見 1.4 節注意事項

1.2 應用場景

1.2.1 填報元件

填報報表中,選擇一個日期填入。如下圖所示:

1.2.2 參數元件

報表中新增日期查詢元件,可以查詢指定日期區間內的報表資料。如下圖所示:

1.3 如何新增

1.3.1 填報元件

被菜儲存格後,點選右側屬性面板的「元件設定」,選擇元件處下拉選擇「日期元件」,如下圖所示:

1.3.2 參數元件

将參數面板控件工具欄中的「日期元件」拖入到參數面板中,如下圖所示:

1.4 注意事項

1)國外普遍認為一個星期從週日開始,而國內普遍認為一個星期從週一開始,為了滿足國內外使用者使用習慣,「日期元件」 提供了星期切換功能。

瀏覽器使用「日期元件」的時候,點選週一即可將週一排在一個星期的第一天,點選週日將週日排在一個星期的第一天。如下圖所示:

日期元件」中日期所屬的週數也會隨對應選擇的星期模式變換。

2)日期元件如果設定了聯動,則在日期選擇介面的任何操作都會及時觸發聯動效果,比如翻頁,切換年月等。所以當單次聯動速度較慢的情況下,如果頻繁點選切換,可能會造成頁面卡死。

3)「日期元件」下拉選項,非本月日期選項將表現為灰色,點選不能選中該日期。

注:11.0.11 及以後,下拉選項中非本月日期選項雖置灰,但支援選擇,如下圖所示:

2. 元件介紹

2.1 屬性

2.1.1 填報元件

新增「日期元件」後,可在右下方設定日期元件的屬性。如下圖所示:

各屬性設定項的詳細介紹如下:

注1:「日期元件」在填報應用時,可透過在儲存格中新增日期值的方式設定預設值,如輸入 2021-06-21。

注2:給「日期元件」賦值的時候,比如默認值、起始日期、結束日期等,爲準确識别,建議都使用 yyyy-MM-dd 的日期格式。

分類設定項詳細介紹
基本元件名稱元件的名稱,手動輸入,通常與參數結合使用,如透過元件名獲取元件後將元件值傳遞給對應參數,預設為無。
可      用

元件是否可用,勾選後,填報時元件可編輯;不勾選,填報時元件灰化,不可編輯,預設勾選。

可      见元件是否可见,勾选后,填报时页面显示元件;不勾选,填报时页面不显示元件,默认勾选。
進階格      式

日期元件的支援的輸入格式,日期型和時間型,預設為日期型。

1)日期型:使用者可以在年月日的範圍內定義查詢日期格式。

2)時間型:使用者可以在年月日時分秒範圍內定義查詢日期格式。

使用者可以透過修改日期格式來變換日期元件的顯示樣式,如修改為"yyyy-MM"來讓元件顯示為年月樣式

注:11.0.5 及之後支援透過設定"yyyy"格式來顯示成年份元件。

使用者可以在格式下拉框中選擇格式,也可以直接填寫格式,當填寫的格式不支援時,範例框中會紅字提醒使用者:

開始日期

元件支援選擇的日期範圍的開始日期,即可以選擇的最小日期值。設定後,不在範圍內的資料將變成灰色不可選取狀態。

有 3 種型別,預設為無

1)無:不做限制

2)日期:可以選擇一個特定的日期

3)公式:直接寫入公式值,如 A1 儲存格為一個日期值,這裏寫 A1,即可引用這個日期值

注:當日期元件有預設值時,設定的開始日期不生效,必須要重新選擇才會生效。

       元件預設值生效邏輯請參見:元件預設值

結束日期

元件支援選擇的日期範圍的結束日期,即可以選擇的最大日期值。設定後,不在範圍內的資料將變成灰色不可選取狀態,支援的型別和「開始日期」相同。

水      印填報時元件內顯示的淺灰色水印文字,手動輸入,以提示使用者需要輸入資訊,點選元件編輯區域後消失,預設為空。
傳回值型別

選擇後,傳回值的格式,分為日期和字串兩種,需要跟資料庫表中日期欄位的型別匹配。

1)日期:傳回值型別是日期型

2)字串:傳回值型別為字串

校驗允许为空是否允許元件不選擇項,勾選後,允許元件不選擇;不勾選,填報校驗和提交時會提示,預設勾選。
錯誤提示不勾選「允許為空」時出現的設定項,可自訂提示資訊。預設情況下將顯示:不能為空
允許直接編輯

是否允許使用者直接輸入值,勾選後,使用者可以直接輸入值,預設勾選。

注:此功能不支援行動端。

2.1.2 参数元件

新增「日期元件」後,可在右下方設定日期元件的屬性。如下圖所示:

各屬性設定項的詳細介紹如下:

注:給「日期元件」指派的時候,比如預設值、開始日期、結束日期等,為準確識別,建議都使用 yyyy-MM-dd 的日期格式。

分類
設定項詳細介紹
基本元件名稱元件的名稱,手動輸入,通常與參數結合使用,如透過元件名獲取元件後將元件值傳遞給對應參數,預設為 dateEditor# 。
可       用元件是否可用,勾選後,填報時元件可編輯;不勾選,填報時元件灰化,不可編輯,預設勾選。
可       見元件是否可見,勾選後,填報時頁面顯示元件;不勾選,填報時頁面不顯示元件,預設勾選。
高級標籤名稱元件的標籤屬性是用在行動端的,行動端不支援參數面板上的「標籤元件」,識別的是普通元件的「標籤名稱」屬性,所以行動端可以用元件的標籤名稱來實現標籤。
控 件 值

元件初始化時的預設值,支援日期、公式、欄位,預設當天日期。

1)日期:日期型,可以選擇一個日期,如下:

3)公式:設計器支持的公式,例如: A1 單元格爲一個日期值,這裏寫 A1。

如果希望日期控件默認值爲空,則可以用公式輸入一個空字符串:'' 來實現。

2)字段:數據集字段,數據集包括模板數據集和服務器數據集。例如:數據集 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 行動端

行動端無可配置項。

3. 應用範例

日期元件的應用,可參見以下文檔:

應用場景實際效果

場景描述:

在日期元件中選擇年月,可查詢到該月份下的天數和周。

參考文檔:

根據日期控件年月查詢某個月份的天和周

場景描述:

透過日期元件,可以在進行資料查詢時,查詢對應於某個日期的前後指定天數的資料

參考文檔:

日期的加減

場景描述:

當資料庫中某張表有時間欄位,且幾乎每分每秒都會有一筆資料生成,為減少報表顯示資料量,我們可以透過時間間隔來篩選資料,僅顯示部分資料。

參考文檔:

根據時間間隔取數

場景描述:

當在報表中新增一個日期元件時,預設會顯示當前的日期,而有些使用者不想讓日期元件顯示預設日期,也可設定實現

參考文檔:

日期控件默認值爲空





附件列表


主題: 參數應用
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 圖片不清晰
  • 用語看不懂
  • 功能說明看不懂
  • 操作說明太簡單
  • 內容有錯誤
中文(繁體)

文 檔回 饋

滑鼠選中內容,快速回饋問題

滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

不再提示

10s後關閉