时间函数

CURDATE 返回当前日期

CURDATE()

返回当前日期，可以在单行文本字段和日期字段中使用。括号中无需填写内容，可以直接使用。

DATEDELTA 指定加/减天数

DATEDELTA(`日期字段`,增加/减少的数量,"时间单位")

指定日期加/减指定数量的单位时间，并返回目标时间。

• 日期字段：需要改变的字段；
• 数量：需要增加/减少的数量，正数为增加，负数为减少，不需要加双引号；
• 时间单位：D、M、Y、H、MIN，分别代表天、月、年、小时、分钟，不填写时间单位是默认单位为天。

示例

DATEDELTA(提交时间,-2,"D")，可以得到提交时间之前2天的日期。

DAYS 日期间隔自然日

DAYS(`日期字段1`,`日期字段2`)

返回日期字段1与日期字段2的差值，单位为天，可返回负值。

实例

例如，DAYS(项目完成时间,项目启动时间)，可以得到项目整个过程的时长天数。

NETWORKDAYS 日期间隔工作日

NETWORKDAYS(`日期字段1`,`日期字段2`)

返回两个日期之间的工作日数。

• 日期字段1：开始日期
• 日期字段2：结束日期

YEAR 年份

返回日期中的年份。

表达式

YEAR(date)

入参

• date：日期字段或日期格式的函数，必填

举例

获取今年的年份数字。

YEAR(CURDATE())

MONTH 月份

返回日期中的月份，月份是介于 1 到 12 之间的整数。

表达式

MONTH(date)

入参

• date：日期字段或日期格式的函数，必填

举例

获取本月的月份数字。

MONTH(CURDATE())

WEEK 周数

返回日期中的周数，周数按年独立计算。

表达式

WEEK(date)

入参

• date：日期字段或日期格式的函数，必填

举例

获取本周是当前年份的第几周的数字

WEEK(CURDATE())

DAY 天数

返回日期中的天数，天数是介于 1 到 31 之间的整数。

表达式

DAY(date)

入参

• date：日期字段或日期格式的函数，必填

举例

获取今天的天数数字。

DAY(CURDATE())

DATEDIF 日期时间差

计算两个日期之间的时间差，两个日期字段：一个代表开始的时间，一个代表结束的时间。

表达式

DATEDIF(start_date,end_date,format)

入参

• start_date：起始时间
• end_date：结束时间
• format：返回格式

返回格式：

占位符	含义
“y”	年
“M”	月
“d”	日
“h”	时
“m”	分
“s”	秒

注意

1. 区分大小写，大写M代表月，小写m代表分
2. 计算方式：计算月份时用天数/30，余数大于0.5的进1。例：45天统计为2个月

举例

获取本次活动从开始到结束共用时多少分钟。

DATEDIF(开始时间,结束时间,"m")

DATE 转换日期对象

将时间戳转换为日期对象，用来将日期组件的时间戳转为日期对象进行日期公式运算。

表达式

DATE(timestamp)

入参

例：将日期【2023-06-19】转换为【Mon Jun 19 00:00:00 CST 2023】 可搭配text函数使用将日期转换成特定格式的文本。TEXT(DATE(日期字段),“yyyyMMdd”)