• 首页 > 
  • 日期和时间类函数

日期和时间类函数

本文档主要介绍宜搭Pro平台目前对“ 插入函数” 功能中支持的日期和时间类函数进行详细说明。

当前时间函数(NOW)

内容项 说明
描述 返回数据填写时的日期时间值。
使用方法 NOW()
样例 返回当前时间。
注意事项
  • 此函数不能有入参,必须保留括号。
  • 返回的是触发时间,即计算发生的时间点。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

当前日期函数(TODAY)

内容项 说明
描述 返回数据填写时的日期。
使用方法 TODAY()
样例 返回当前日期。
注意事项
  • 此函数不能有入参,必须保留括号。
  • 返回的是“触发日期”,即计算发生的日期。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

时间秒数函数(SECOND)

内容项 说明
描述 返回日期时间值的“秒数”,返回的是0~59之间的正整数。
使用方法 SECOND(datetime)
样例 SECOND(DATETIME(2020,9,15,23,34,5)),返回值为5(入参为 2020年9月15日 23点34分05秒)。
注意事项
  • 原则上要求入参类型为日期时间值。
  • 如果入参是日期,会自动以00:00:00来补足,此时函数返回的是0。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

时间分钟数函数(MINUTE)

内容项 说明
描述 返回日期时间值的“分钟数”,返回的是0~59之间的正整数。
使用方法 MINUTE(datetime)
样例 MINUTE(DATETIME(2020,9,15,23,34,5)),返回值为34(入参为2020年9月15日23点34分05秒)。
注意事项
  • 原则上要求入参类型为日期时间值。
  • 如果入参是日期,会自动以00:00:00来补足,此时函数返回的是0。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

时间之间的分钟数函数(MINUTES)

内容项 说明
描述 返回两个日期时间值之间的“分钟”差值。
使用方法 MINUTES(end_time,start_time),返回end_time减去start_time后的小时差值。
样例 MINUTES(DATETIME(2020,9,15,23,34,5),DATETIME(2020,9,14,17,3,45)),返回值为1831。
注意事项
  • 原则上要求入参类型为日期时间值。
  • 如果入参是日期,会自动以00:00:00来补足。
  • 日期时间数值中的“秒”位 不参与计算。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

时间小时数函数(HOUR)

内容项 说明
描述 返回日期时间值的“小时数”,返回的是0~23之间的正整数。
使用方法 HOUR(datetime)
样例 HOUR(DATETIME(2020,9,15,23,34,5)),返回值为23(入参为 2020年9月15日 23点34分05秒)。
注意事项
  • 原则上要求入参类型为日期时间值。
  • 如果入参是日期,会自动以00:00:00来补足,此时函数返回的是0。
  • 分、秒不参与计算,恒定返回的是0-23之间的正整数。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

时间之间的小时数函数(HOURS)

内容项 说明
描述 返回两个日期时间之间的小时差值。
使用方法 HOURS(end_time,start_time),返回end_time减去start_time后的小时差值。
样例 HOURS(DATETIME(2020,9,15,23,34,5),DATETIME(2020,9,14,17,3,45)),返回值为30。
注意事项
  • 原则上要求入参类型为日期时间值。
  • 如果入参是日期,会自动以00:00:00来补足。
  • 分、秒不参与计算。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

日期天数函数(DAY)

内容项 说明
描述 根据入参的日期/日期时间,返回该日期中的“日”,返回1-31之间的正整数。
使用方法 DAY(date),返回date天数值。
样例 DAY(DATETIME(2020,9,15,23,34,5)),返回值为15。
注意事项
  • 入参类型必须是日期或日期时间,否则前端显示为空。
  • 日期值必须合理,类似2019-02-31也显示为空。
  • 返回的是整数。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

日期之间的天数函数(DAYS)

内容项 说明
描述 根据两个日期/日期时间值之间的“天数”差值。
使用方法 DAYS(end_date,start_date),返回end_date减去start_date后的天数差值。
样例 DAYS(DATETIME(2020,9,15,23,34,5),DATETIME(2020,9,14,17,3,45)),返回值为1。
注意事项
  • 入参类型必须是日期或日期时间,否则前端显示为空。
  • 日期\日期时间入参值必须合法,类似2019-02-31也显示为空。
  • 返回值为整数。
  • 时、分、秒不参与计算。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

日期的月份函数(MONTH)

内容项 说明
描述 根据入参的日期或日期时间,返回该日期中的“月”。
使用方法 MONTH(date),返回date的月份数值。
样例 MONTH(DATETIME(2020,9,15,23,34,5)),返回值为9。
注意事项
  • 入参类型必须是日期或日期时间,否则前端显示为空。
  • 日期值必须合法,类似2019-02-31也显示为空。
  • 返回的是正整数,在1-12之间。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

日期所属季度函数(QUARTER)

内容项 说明
描述 根据入参的日期或日期时间,返回该日期的“季度”值。
使用方法 QUARTER(date),返回date的季度数值,恒定为1~4之间的正整数。
样例 QUARTER(DATETIME(2020,9,15,23,34,5)),返回值为3(3季度)。
注意事项
  • 入参类型必须是日期或日期时间,否则前端显示为空。
  • 日期值必须合法,类似2019-02-31也显示为空。
  • 返回的是正整数,在1~4之间。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

日期的年份函数(YEAR)

内容项 说明
描述 根据入参的日期或日期时间,返回该日期中的“年”数值。
使用方法 YEAR(date),返回date的年份数值。
样例 YEAER(DATETIME(2020,9,15,23,34,5)),返回值为2020。
注意事项
  • 入参类型必须是日期或日期时间,否则前端显示为空。
  • 日期值必须合法,类似 2019-02-31也显示为空。
  • 返回的是正整数,系统支持1970~9999之间的年份表达。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

日期之间的年数函数(YEARS)

内容项 说明
描述 根据两个日期或日期时间值之间的年数差值。
使用方法 YEARS(end_date,start_date),返回end_date减去start_date后的年数差值。
样例 DAYS(DATETIME(2020,9,15,23,34,5),DATETIME(2018,9,14,17,3,45)),返回值为2。
注意事项
  • 入参类型必须是日期或日期时间,否则前端显示为空。
  • 日期或日期时间入参值必须合法,类似2019-02-31也显示为空。
  • 返回值为整数。
  • 月、日、时、分、秒不参与计算。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

数字转日期函数(DATE)

内容项 说明
描述 数字转日期,入参必须是整数。
使用方法 DATE(year,month,day)
样例 DATE(2020,1,4),返回2020年1月4号这个日期值。
注意事项
  • 根据输入的年月日的值,返回日期类型的数据。其中年、月、日三个入参均为必填。
  • 年份只接受1970~9999之间的正整数,月只接受1~12之间的正整数,日只接受1~31之前的正整数。
  • 错误日期 如 1998,2,31 返回null。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

数字转日期时间函数(DATETIME)

内容项 说明
描述 数字转日期,入参必须是整数。
使用方法 DATE(year,month,day,hour,minute,second)
样例 DATE(2020,1,4,23,59,48),返回2020年1月4号23点59分48秒 这个日期时间值。
注意事项
  • 根据输入的年、月、日、时、分、秒的值,返回日期时间类型的数据。其中年、月、日、时、分、秒六个入参均为必填。
    • 年份只接受1970~9999之间的正整数,月只接受1~12之间的正整数,日只接受1~31之间的正整数。
    • 时只接受0~23之间的整数,分、秒只接受0~59之间的整数。
    • 错误日期时间,如 1998,2,14,28,9,7 返回null。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

文本转日期(DATEVALUE)

内容项 说明
描述 文本转日期,入参需为文本型值。
使用方法 DATEVALUE(expression),返回值为年月日格式的日期型值。
样例 DATEVALUE(FORMATNUM(YEAR(TODAY()),”####”)&”-06-05”),返回一个以today的年份的6月5号日期。
注意事项
  • 如果入参不是一个有效的日期格式文本,则前端显示空。
  • 当输入日期时,需要使用 英文引号 将日期括起来,并使用以下格式YYYY-MM-DD 来写。
  • 年份只接受1970~9999之间的正整数,月份只接受1~12之间的正整数,日只接受1~31之间的正整数。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

文本转日期时间(DATETIMEVALUE)

内容项 说明
描述 文本转日期时间,入参需为文本型值。
使用方法 DATETIMEVALUE(expression),返回值为年月日时分秒格式的日期时间型值。
样例 DATETIMEVALUE(“2020-06-09 15:35:42”)
注意事项
  • 如果入参不是一个有效的日期时间格式文本,则前端显示空。
  • 当输入日期时,需要使用 英文引号 将日期括起来,并使用以下格式YYYY-MM-DD HH:MM:SS 来写。
  • 年份只接受1970-9999之间的正整数,月份只接受1~12之间的正整数,日只接受1~31之间的正整数。
  • 时只接受0~23之间的整数,分秒均只接受0~59之间的整数。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

星期函数(WEEKDAY)

内容项 说明
描述 根据入参日期或日期时间,返回是周几的函数。
使用方法 WEEKDAY(date),返回值1~7之间的正整数,周一返回1,以此类推。
样例 WEEKDAY(DATE(2020,7,1))返回值为3。
注意事项
  • 如果入参不是一个有效的日期/日期时间格式值,则前端显示空。
  • 返回值为1~7之间的正整数,周一为1,周二为2并以此类推。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

日期加天数(ADDDAY)

内容项 说明
描述 返回日期加、减天数后的日期值。
使用方法 ADDDAY(date,number),返回date加上number天数后的日期值。
样例
  • ADDDAY(DATE(2020,7,1),2),返回值为2020年7月3日。
  • ADDDAY(DATE(2020,7,1),-2),返回值为2020年6月29日。
注意事项
  • date入参如不是一个有效的日期或日期时间格式值,则前端显示空。
  • number必须是整数。
  • 如果要减去天数,输入一个负整数即可。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

时间加小时(ADDHOUR)

内容项 说明
描述 返回日期时间加、减小时后的日期值。
使用方法 ADDHOUR(datetime,number),返回datetime加上number小时数后的日期时间值。
样例
  • ADDHOUR(DATETIME(2020,7,1,23,45,36),2),返回值为2020年7月2日1点45分36秒。
  • ADDHOUR(DATETIME2020,7,1,23,45,36),-2),返回值为2020年7月1日21点45分36秒。
注意事项
  • datetime入参如不是一个有效的日期时间格式值,则前端显示空。
  • number必须是整数。
  • 如果要减去小时数,输入一个负整数即可。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则

周数函数(WEEKNUM)

内容项 说明
描述
  • 返回特定日期在一年中的“第几周”。
  • return_type默认1是周日开始,2是周一开始(以此类推)。
  • 返回的是整数。
使用方法 WEEKNUM(date,return_type),返回特定日期是一年中的第几周。
样例 IF(WEEKNUM([创建时间])==WEEKNUM(TODAY()),”本周新增”,”历史数据”),此表达式判定当数据创建时间为“本周”时,返回“本周新增”,否则返回“历史数据”
注意事项
  • 如果入参不是一个有效的日期或日期时间格式值,则前端显示空。
  • Return_type为选填,默认1是周一开始,2是周二开始(以此类推)。
  • 返回的是整数。
函数应用位置
  • 字段默认值
  • 公式字段计算
  • 校验规则