datawind可视化查询-日期函数

飞书文档学习链接：https://www.volcengine.com/docs/4726/47275

1 常用函数快速入门

日期函数用于作时间格式转换、时间处理、获取指定日期等。

1.1 将文本转换为时间或日期

格式：

• toDate(xxx)和 to_date(xxx)，将 yyyymmdd 或 yyyy-mm-dd 样式的字符串字段转换成日期格式
• toDateTime(xxx)，将 yyyy-mm-dd hh:mm:ss 样式的字符串转换成时间格式
• toDateOrNull(xxx) 和 toDateTimeOrNull(xxx)，功能与上述 1 和 2 相同，适用于字段中存在脏数据的情况，会将脏数据转换成空值

示例：

字段A	toDate(字段A)	toDateTime(字段A)
2020/12/21	2020/12/21	2020/12/21 0:00
20201221	2020/12/21	2020/12/21 0:00
2020/12/21 18:00	2020/12/21	2020/12/21 18:00

字段A为字符串类型，toDate(字段A)和 toDateTime(字段A)为时间格式

1.2 时间与时间戳相互转换

格式：将时间或文本类型的时间转换成时间戳 toUnixTimestamp(xxx)，即将 yyyy-mm-dd hh:mm:ss 转换成时间戳

示例：

字段A	toUnixTimestamp(字段A)	扩展：toDateTime(toUnixTimestamp(字段A)+28800)
2020/12/21 18:00	1608544800	2020/12/22 2:00

扩展：对转换后的时间戳，加上 8 小时对应的时间戳差值 28800，完成从 UTC+0 到 UTC+8 的转换，然后再通过 toDateTime 函数转换成可读性更强的时间格式。

1.3 返回当前日期

格式：now()，生成一个随系统实时时间变化的动态参数

示例：现在时间是 2020-12-21 18:00:00，写下 now()作为一个字段，则这个字段当前值为 2020-12-21 18:00:00，一小时后为 2020-12-21 19:00:00

1.4 返回本周周一的日期

格式：toMonday(xx)，对日期字段向前取到本周一对应的日期

示例：

字段A	toMonday(字段A)
2020/12/22	2020/12/21

2 功能详解

函数名称	函数格式	用途	示例
toDateTime	toDateTime(x)	将字符型时间日期转化为时间日期型	toDateTime('2018-12-24 10:10:00')
toStartOfFiveMinute	toStartOfFiveMinute（x）	截取时间日期到最近的 5 的倍数分钟（之后归零），返回日期	toStartOfFiveMinute(toDateTime('2018-12-11 11:12:13')) 返回 2018-12-11 11:10:00
now	now（)	生成当前时间日期	now( ) 返回 2018-12-13 10:10:12
toStartOfFifteenMinutes	toStartOfFifteenMinutes（x)	截取时间日期到最近的 15 的倍数分钟（之后归零），返回日期	toStartOfFifteenMinute(toDateTime('2018-12-11 11:12:13')) 返回 2018-12-11 11:00:00
toStartOfInterval	toStartOfInterval(time_or_data, INTERVAL x unit [, time_zone])	这是名为 toStartOf*的所有函数的通用函数。例如，toStartOfInterval（t，INTERVAL 1 year）返回与 toStartOfYear（t）相同的结果，toStartOfInterval（t，INTERVAL 1 month）返回与 toStartOfMonth（t）相同的结果， toStartOfInterval（t，INTERVAL 1 day）返回与 toStartOfDay（t）相同的结果， toStartOfInterval（t，INTERVAL 15 minute）返回与 toStartOfFifteenMinutes（t）相同的结果。	toStartOfInterval(toDateTime('2019-10-10 09:09:20'),INTERVAL 1 year) 返回 2019-01-01
toIntervalDay	toIntervalDay(x)	日期转化为时间戳，天级别	toIntervalDay(toDateTime('2019-08-12 11:12:13')) 返回 1565579533
toIntervalMinute	toIntervalMinute(x)	日期转化为时间戳，分钟级别	toIntervalMinute(toDateTime('2019-08-14 11:12:13')) 返回 1565579533
toIntervalHour	toIntervalHour(x)	日期转化为时间戳，小时级别	toIntervalHour(toDateTime('2019-08-14 11:12:13')) 返回 1565579533
toMonday	toMonday(x)	将 Date 或 DateTime 向前取整到本周的星期一。 返回 Date 类型。	toMonday(toDateTime('2019-08-14 11:12:13')) 返回 2019-08-12
toStartOfHour	toStartOfHour(x)	将DateTime向前取整到当前小时的开始。	toStartOfHour(toDateTime('2018-12-11 11:12:13')) 返回 11
today	today( )	生成今天的日期	today( ) 返回 2018-12-13
toHour	toHour(x)	取时间日期的小时	toHour(toDateTime('2018-12-11 11:12:13')) 返回 11
toStartOfTenMinutes	toStartOfTenMinutes(x)	将 DateTime 以十分钟为单位向前取整到最接近的时间点	toStartOfTenMinute(toDateTime('2018-12-11 11:12:13')) 返回 2018-12-11 11:00:00
toStartOfDay	toStartOfMinute(string date time)	将 DateTime 向前取整到当日的开始。
toYear	toYear(string date)	返回日期中的年
toRelativeWeekNum	toRelativeWeekNum(date)	将 Date 或 DateTime 转换为星期数，从过去的某个固定时间点开始。
toMonth	toMonth(string date)	返回日期中的月
toStartOfMinute	toStartOfMinute( )	截取时间日期到分钟（之后归零），返回日期	toStartOfMinute(toDateTime('2018-12-11 11:12:13')) 返回 2018-12-11 11:12:00
toUnixTimestamp	toUnixTimestamp( )	将 DateTime 转换为 unix 时间戳
addDays	addDays(date_time,int)	函数将一段时间间隔添加到 Date/DateTime，然后返回 Date/DateTim
toRelativeYearNum	toRelativeYearNum(date_time)	将 Date 或 DateTime 转换为年份的编号，从过去的某个固定时间点开始
year	year(Date/DateTime/String date)	返回日期中的年	year(toDateTime('2018-12-11 11:12:13'))返回 2018
month	month(Date/DateTime/String date)	返回日期中的月	month(toDateTime('2018-12-11 11:12:13'))返回 12
quarter	quarter(Date/DateTime/String date)	返回日期中的季度数	quarter(toDateTime('2018-12-11 11:12:13'))返回 12
day	day(Date/DateTime/String)	返回 dayOfMonth	day('2019-09-12') 返回 12
last_day	last_day(Date/DateTime/String date)	返回日期所在的月份的最后一天	last_day(toDateTime('2018-12-11 11:12:13'))返回 2018-12-31
next_day	next_day(Date/DateTime/String date, string day_of_week)	返回日期中的下一个星期day_of_week	next_day(toDate('2015-01-14'), 'TU') 返回 2015-01-20
dateDiff	dateDiff(Date/DateTime date1, Date/DateTime date2 [, String timezone])； dateDiff(String unit, Date/DateTime date1, Date/DateTime date2 [, String timezone])	返回两个日期的差值	dateDiff(now(), yesterday())返回 -1
date_sub	date_sub (string/Date/DateTime startdate, int days)	返回start_time 前 days 天的日期/时间	date_sub('2019-09-08', 1) 返回'2019-09-07'
date_add	date_add (string/Date/DateTime startdate, int days)	返回start_time 后 days 天的日期/时间	date_add('2019-09-08', 1) 返回'2019-09-09'
from_unixtime	from_unixtime(Date/DateTime/UInt32 date, String parttern[, String timezone])	将日期或时间戳转换为 pattern 形式的字符串	from_unixtime(toDateTime('2019-09-09 09:00:00'), 'time: %F %T', 'Asia/Shanghai') 返回'time: 2019-09-09 09:00:00'
to_date,toDate	to_date(String/UInt16 date)	将字符串/自 1970-01-01 起的第 date 天转换为日期类型	toDate('20190909') 返回'2019-09-09'
date_format	date_format(Date/DateTime/String, String pattern)	将日期按指定格式输出	date_format('2019-09-09', 'yyyy') 返回 '2019'
unix_timestamp	unix_timestamp(Date/DateTime/String)	将日期转换为 timestamp	unix_timestamp(toDateTime('2019-09-09 09:00:00'), 'time: %F %T', 'Asia/Shanghai') 返回'time: 2019-09-09 09:00:00'
toWeek	toWeek(date[,mode])	返回日期所在的周, 范围[0, 53]	toWeek(toDate('2019-12-06'), 3) 返回 49
toDayOfWeek	todayofweek(date)