时间宏的使用案例

观小数发表于:2020年04月01日 11:02:06更新于:2020年12月30日 17:36:00

背景介绍:

在一些场景中,我们需要显示当日或者昨日的具体时间,此时需设置动态时间。动态时间在卡片标题、筛选器默认值、订阅预警等多处被使用。观远数据支持该功能,具体使用方法如下:

  1. 进入卡片编辑页面

  2. 在卡片标题中添加3个花括号{}以及表征时间的关键词

注:关键词外面必须包含三层花括号。

0015e8409bbe2a8ca032de5808c3f3c

时间宏主要2种类型:时间点类型和偏移类型。

时间点类型的,比如今天、昨天等,常见用法有以下几种:

0015e840aab79f1d3d07e2f2a7d6cec

偏移类型的,如2天前、两周前等,常见用法有以下几种:

0015e840ac8ab22b926875133bc83e2

将时间点类型和偏移类型结合起来,就可以创建自定义的区间时间,比如最近7天:

0015e840adb5d2004212f077e3d31dd

根据分析场景的需要,最近7天也可以定义为从今天开始算:起始为 today -6 days,结束为 today。

  • 时间宏表达式一般返回日期类型,如“2020-12-30“,若有需要,也可以对时间宏进行格式设置,比如返回年、月,只需在时间宏后面加“%”、“y”、“M”、“d”等。

具体用法举例如下:

0015fec49a744ea4bd677ea7f694c6c

以上格式也可组合使用,如输入“today %y年M月d日 E”,以2020年8月27日为例,可得到“2020年8月27日 星期四”;以2020年12月30日为例,可得到“2020年12月30日 星期三”。

(注:格式中间可加其他文字,如 年、月、日,使得时间宏转化输出的内容更具可读性)

其他注意事项:

1、其中 %w 出来的周数,是以周日为一周的第一天,所以会有点误差,如果想要周一为一周的第一天,可以通过 -1 days 进行修正,比如:{{{yesterday -1 days% w}}}

2、大写的Y代表的是Week year,如果需要的是自然年周,推荐使用小写的y,相关案例参考:sql日期里大写Y和小写y的区别


使用案例

1、将当前日期转化为 2020_Q01 形式的季度:{{{today%yyyy_'Q'QQ}}}

2、包含中文的季度 {{{today%yyyy_第QQ季度}}}

3、具体某个周、月份、季度:

0015e840c8d3a9f3669f5725b2cf164

4、前年:{{{first day of last year - 12 months}}}

5、上上月的最后一天:{{{last day of last month-1 months}}}

    您需要登录后才可以回复