日期组件

更新时间:2021-07-23

过滤组件如何对图表数据进行过滤,详见过滤组件关联图表

日期的默认值

日期可选的默认值如下:

图片

其中自定义默认值支持多种相对语法,例如:

  • 可输入正负数:将以当天为基准进行计算,如: -1 表示昨天,+1 表示明天
  • 绝对日期:请填写 $绝对日期,如:$20180101
  • 支持星期配置:如果是本周一请写$MONDAY,本周二请写$MONDAY+1
  • 本月一号:$MONTHFIRSTDAY,本月最后一天:$MONTHFIRSTDAY+1M-1,上月第一天:$LASTMONTHFIRSTDAY,上月最后一天:$MONTHFIRSTDAY-1
  • 本季度第一天:$QUARTERFIRSTDAY,本季度第二天:$QUARTERFIRSTDAY+1
  • 本年第一天:$YEARFIRSTDAY,本年第二天:$YEARFIRSTDAY+1,去年第一天:$LASTYEARFIRSTDAY,去年最后一天:$YEARFIRSTDAY-1
  • 数据开始日期请写 $STARTDAY,数据结束日期请写 $ENDDAY,这两项仅在设置动态基准日期后生效

可以使用+、-进行年(Y)、月(M)、周(W)、日(D)的计算,比如两年半前的月末请写$MONTHFIRSTDAY-2Y-5M-1D,三个月前的 1 号请写$MONTHFIRSTDAY-3M,D 可省略不写。

日期可选范围

这里规定了在本过滤条件中日期的可选定范围,和「默认值」基本相同。

日期的高级设置

日期类型的过滤条件支持新增多个自定义快捷键,语法和上面的「默认值」自定义语法相同:

图片

日期的字体大小

在大屏中,可以通过设置字体大小,来调整日期组件的大小,默认是 16px,设置和效果如下图所示:

图片

动态基准日期

当需要根据数据中的起止日期来设置默认日期或可选范围时,可以开启动态基准日期,这样就可以用数据中的结束日期作为基准日期来设置默认值或可选范围。例如绑定数据后默认值的【今天】就是数据中的结束日期。支持数据模型、SQL 建模、API 拉取三种数据绑定方式。日期范围、日期时间范围等日期类过滤条件都支持动态基准日期设置。

图片

自定义方式的数据开始日期请写 $STARTDAY,数据结束日期请写 $ENDDAY,其他相对语法也可以结合使用,例如数据结束日期的当月最后一天 $ENDDAY$MONTHFIRSTDAY+1M-1。

SQL 建模方式需要查询最小日期和最大日期,如果查询的字段为日期类型查询语句如下,其他类型的字段需在语句中转换成日期类型来查询 MIN MAX

SELECT MIN(orderDate) AS MINDATE, MAX(orderDate) AS MAXDATE  FROM salesdata;

注意一定要写查询字段别名 MINDATE 和 MAXDATE 这两个固定的字符串,字段模型的数据类型都设置为日期或时间。如果控制面板中没有「数据」可能是当前页面没有使用到数据模型的图表。

API 拉取方式的要求

本页内容