Quick BI：日期查詢

前提條件

• 已建立儀表板，並且儀表板圖表中包含日期欄位。

• 該儀表板添加一個空的查詢控制項，請參見建立查詢控制項。

操作步驟

您可以按照下圖指引，配置日期查詢控制項。

基礎配置

展示類型

日期查詢控制項支援日期選擇。

時間粒紋

• 當關聯的日期欄位為年、月、日時，時間粒紋與關聯的日期欄位粒度保持一致，例如關聯的日期欄位為年欄位，時間粒紋為年；關聯的日期欄位為月欄位，時間粒紋為年-月；關聯的日期欄位為日欄位，時間粒紋為年-月-日。

• 當關聯的日期欄位為年月日時分秒欄位時，支援使用時間粒度切換，請參見本文日期粒度切換部分的內容。

資料來源

查詢控制項的資料來源支援預設日期選框和資料集欄位，當資料來源選擇預設日期選框時，支援日期級聯；當資料來源選擇資料集欄位時，支援同源級聯、非同源級聯和日期級聯。

• 預設日期選框

  不存在任何資料來源，僅支援日期級聯，不支援和其他控制項進行級聯。

  

• 資料集欄位

  選擇資料集作為資料來源，除支援日期級聯外，還支援和下拉、樹形控制項進行級聯。

  

設定時間篩選範圍

通過設定查詢的時間範圍來控制資料篩選量。設定時間篩選範圍後，超出的時間範圍無法選擇。

• 區間類型預設為無，支援開始於、結束於和時間區間。

  

• 以區間類型為開始於為例，設定相對時間範圍。您可以按照下圖指示配置相對時間。

  

  說明

  T的粒度選擇支援下拉選擇目前時間粒度包含的所有粒度，如目前時間粒度為年-月-日，則可以下拉切換選擇年、月、日這三個粒度；如目前時間粒度為年-月-日-時-分-秒，則可以選擇T的粒度為年、月、日、時、分、秒。

  適用情境例如當時間粒紋為年月日時分秒時，切換秒的相對時間，如果時間粒紋只有秒，那麼計算需要多少秒比較麻煩，此時可以切換到日粒度，快速查看不同日期下的時間資料。

• 以區間類型為開始於為例，設定精確時間範圍。

  

• 如果選中動態查詢時間視窗，並設定單次最多查詢的時間量，則可以在設定的時間篩選範圍內，限制單次最多查詢的時間量。

  

篩選方式

支援單日或日區間篩選，具體配置及效果請參見本文單日期查詢、日期區間查詢部分的內容。

設定預設值

您可以通過手動設定或動態函數的方式，設定預設值。

• 您可以手動設定相對時間或精確時間的預設值。

  

• 當天或昨日資料未產出時，用相對時間或精確時間無法準確選擇時間，可以用動態函數去擷取有資料的日期。

  

  • 篩選方式為單日時，預設時間支援設定為查詢值欄位最大值、查詢值欄位最小值或查詢值欄位第一項。

    

  • 篩選方式為區間（如日區間、月區間等），區間類型設定為開始於、結束於或時間區間時，預設時間支援設定為開始於、結束於查詢欄位最小值或查詢欄位最大值。

    說明

    支援僅設定開始於或結束於，當開始時間和結束時間都設定的時候，開始時間不能大於結束時間。

    

開啟日期前後快捷切換

開啟後，會在報表頁面的日期篩選框新增一個快捷切換。

單日期查詢

以訂單日期（day）為例，為您展示某天的銷售資料。

1. 在儀表板管理頁面，選擇已建立好的儀表板，該儀表板組件含以下圖表和查詢控制項。

   

2. 在查詢控制項上單擊進階配置。

3. 在查詢條件設定頁面，按照下圖指引，設定查詢條件。

   

4. 配置完成後，在查詢條件中選擇日期，並單擊查詢，查看某日的銷售情況。

   

日期區間查詢

以訂單日期（day）為例，為您展示某一段時間內的某門店的盈利情況。

1. 在儀表板管理頁面，選擇已建立好的儀表板，該儀表板組件含以下圖表和查詢控制項。

   儀表板圖表中需要包含日期欄位。

   

2. 在查詢控制項上單擊進階配置。

3. 在查詢條件設定頁面，按照下圖指引，設定查詢條件。

   

4. 配置完成後，在查詢條件中選擇日期，並單擊查詢，查看某一段時間內的某門店的盈利情況。

   

   篩選方式為區間時，您還可以使用以下功能，方便您更好地查看資料。

   • 區間類型：支援開始於、結束於、時間區間和快捷區間這四種類型。

     開始於

     

     結束於

     

     時間區間

     快捷區間

     

   • 定製快捷區間：支援多種區間情境，方便您定製化設定快捷區間的值。您可以在下拉式清單裡快速勾選快捷區間或根據實際需求添加自訂快捷區間。

     

     說明

     僅當區間類型為快捷區間時，支援配置該選項。

     • 您可以在下拉式清單中快速勾選快捷區間，不同時間粒紋可勾選的快捷區間也不同，具體請參見查詢類型配置展示。

       

     • 若系統內建的快捷區間無法滿足您的需求，您可以點擊添加自訂快捷區間進行自訂配置。

       說明

       自訂快捷區間僅對當前查詢條件生效。

       

       在自訂快捷區間配置介面，您可以進行以下配置。

       

       配置項	說明
       區間名稱	自訂快捷區間的名稱。
       基準時間	基準時間支援設定為今天、昨天或自訂。 說明 T代表今天，樣本：T+1代表明天，T-1代表昨天。 基準時間是您定義日期區間的起點參考。您先選擇一個基準時間，後續的日期區間將基於這個基準時間向前或向後計算。 舉個例子，如果今天是2025年10月17日，基準時間設為 “昨天”（即2025年10月16日），區間範圍設為 “最近3日”，那麼實際查詢的日期範圍就是從昨天的前2天到昨天，即2025年10月14日至2025年10月16日。
       區間範圍 說明 區間範圍需要在設定好基準時間後再進行配置。	“最近xx”區間範圍：將在基準時間基礎上產生相應“最近N個周期”的動態區間範圍。不同時間粒紋可設定的區間範圍也不同，例如，時間粒紋為日，可設定為最近N日/月/年。 自訂配置區間範圍：若最近N個周期的設定不滿足您的需求，您可以對區間的開始時間和結束時間分別設定相對時間或精確時間。
       區間預覽	區間預覽將基於所選的基準時間和區間範圍即時更新，您可以檢查所配置的區間是否符合預期。

   • 設定僅起止時間關聯的圖表：在儀表板中，您可以設定僅起止時間關聯的圖表，讓同一個日期區間對不同的圖表生效。

     支援三種時間範圍的篩選：

     • 限定開始時間

       

     • 限定結束時間

       

     • 限定時間區間

       

     說明

     僅當區間類型為時間區間時，支援配置該選項。

日期粒度切換

當日期查詢控制項中的關聯欄位設定為年月日分秒（例如：訂單日期（ymdhms））時，您可以切換日期查詢控制項中的日期粒度，以快速在一個圖表中查看不同時間視角下的資料資訊。例如，原先可能需要用多個儀表板或者用幾個Tab來區分不同時間粒紋，現在只需要通過一個控制項切換即可。

支援將日期查詢控制項配置為日期粒度切換僅控制日期控制項或同步控製圖表，兩者區別如下：

日期粒度切換僅控制日期控制項

日期查詢控制項中的日期粒度值，將僅對日期控制項的篩選項生效。您可以根據以下說明進行配置。

1. 在查詢條件設定頁面，按照下圖指引，設定查詢條件。

   本例中，日期欄位選擇訂單日期（ymdhms）。

   其中，在基礎配置地區，參數配置說明如下：

   • 時間粒紋：關聯欄位選擇時間粒紋欄位後，時間粒紋中會自動填滿一個預設值。

     當關聯欄位為訂單日期（ymdhms）時，除了預設值年-月-日-時-分-秒外，還支援添加年、年-季度、年-月、年-周、年-月-日，您可以根據對時間粒紋的需要，在時間粒紋下拉框中選擇或刪除不同時間粒紋。

   • 分粒度設定：設定分粒度後，您可以快速在一個儀表板頁面中查看不同時間視角的資料資訊。

     說明

     僅當時間粒紋選擇兩個及以上的值時，才需要支援配置分粒度。

     

   • 設定預設篩選值：為查詢控制項設定預設值。

     分粒度設定後，您也可以為每個時間粒紋單獨設定不同的預設值，方便您在切換時間粒紋時，快速查詢資料資訊。

     

2. 配置完成後，在查詢條件中切換粒度，選擇日期並單擊查詢。

   

   您也可以切換分粒度，快速查詢資料。

   

日期粒度切換同步控製圖表

在圖表欄位面板中配置了日期維度組的前提下，您可以為當前查詢控制項設定在切換時間粒紋時，同步控製圖表中展示的時間維度。具體操作步驟如下。

1. 為需要被同步控制時間粒紋的圖表，配置日期維度組。

   1. 在圖表的資料面板中，點擊表徵圖，選擇下拉式清單下的建立維度組。

   2. 在建立維度組欄位彈窗中按需配置日期欄位，完成後點擊確定。

   3. 將建立好的日期維度組欄位拖入圖表欄位面板中，點擊更新。

2. 添加查詢控制項，並在查詢條件設定頁面，設定查詢條件。

   

   配置內容		配置說明
   地區 ①	查詢控制項名稱	填寫自訂查詢控制項名稱，您可以根據查詢控制項的作用命名，例如：日期篩選。
   地區 ②	圖表及關聯欄位	選取查詢控制項需要同步控制日期粒度的圖表，及需要關聯的年月日分秒欄位。 說明 未在此處被勾選上的圖表，將不會受到查詢控制項時間粒紋切換的影響。例如圖中未勾選的明細表。 在此處已勾選的圖表，如果圖表自身沒有設定維度組，也不會受到查詢控制項時間粒紋切換的影響。
   地區 ③	基礎配置	您需要在此處選中時間粒紋切換同步控製圖表維度選項，以確保查詢控制項中的日期粒度值能同步生效至關聯圖表中。其餘參數配置同日期粒度切換僅控制日期控制項中的操作。 說明 請確保需同步控制的圖表已配置好對應的日期維度組欄位。 建議控制項中的時間粒紋與圖表維度組中的時間粒紋一一對應。

3. 配置完成後，在查詢控制項中選擇時間粒紋、設定日期區間並單擊查詢，關聯圖表展示的時間粒紋將被同步切換。

   說明

   當資料集配置了財年時，查詢控制項的財年開始於跟隨資料集中的欄位配置，不支援修改。財年的配置請參見建立資料集。