日期公式简介
日期时间字段 的返回值为时间戳(timestamp),单位是毫秒;本文中的日期函数的参数均可直接使用日期字段。如,YEAR(日期时间字段)。
下面介绍关于日期函数的两个基本概念:
时间戳(timestamp):时间戳是计算机记录时间的一种格式。通常是一个字符序列,唯一地标识某一刻的时间。在简道云表单中,「日期时间」字段便是由这样的序列来存储的。
日期对象:可以理解为年月日时分秒;日期对象的格式为 Sat Aug 01 2015 00:00:00 GMT+0800,即北京时间 2015 年 8 月 1 日 00:00:00,日期对象可以进行各种运算,比如日期加减法等等。
DATEDELTA-日期加减
函数含义:将返回现在的时间
函数用法:DATEDELTA(日期字段, 天数)
函数示例:将表单日期字段「今天」的数据值加三天,可设置公式为DATEDELTA(今天,3),返回结果为2023-09-18。
显示效果:
函数返回值:日期对象或字符。
DATE-日期
函数含义:将时间戳转换为日期对象或将时间戳进行格式化。
函数用法:
DATE(日期字段)
DATE(year,month,day)
DATE(year,month,day,hour,minute,second)
DATE(日期字段,‘yyyyMMdd’) 格式化
DATE(日期字段,‘今天是yyyy 年 MM 月 dd 日 E HH 点 mm 分 ss 秒’)
函数示例:
将表单日期字段「今天」数据值格式化为2023915,可设置公式为DATE(今天,‘yyyyMMdd’),返回结果为2023915。
函数返回值:数字。
DAY-日期的天数(几号)
函数含义:返回某日期的天数。
注意:天数是介于 1 到 31 之间的整数。
函数用法:DAY(日期字段)
函数示例:获取表单日期控件字段「今天」是本月的几号,则可设置公式为DAY(今天)
,今天为2023-9-15,则返回值为15。
函数返回值类型:数字。
DAYS-日期之间的天数
函数含义:返回两个日期之间的天数。
函数用法:DAYS(起始日期,结束日期)
函数示例:
如:获取请假开始日期与请假结束日期之间的天数,则设置公式为DAYS(请假开始日期,请假结束日期)
HOUR-时间的小时
函数含义:返回某日期的小时数。
函数用法:HOUR(日期字段)
函数示例:获取表单字段「今天」日期字段中的小时数,则可设置公式为HOUR(今天),即2023-9-16 9:43返回9。
函数返回值类型:数字。
ISOWEEKNUM-时间的周数
函数含义:返回给定日期在全年中的ISO周数。
函数用法:ISOWEEKNUM(日期字段)
函数示例:获取表单字段「今天」日期字段在全年ISO中第几周,则可设置公式为ISOWEEKNUM(今天),即2023-9-16 返回38。
函数返回值类型:数字。
YEAR-时间的年份
函数含义:返回某日期的年份。
函数用法:YEAR(日期字段)
函数示例:获取表单字段「今天」日期字段日期所在年份,则可设置公式为YEAR(今天),即2023-9-16 返回2023。
函数返回值类型:数字。
MONTH-时间的月份
函数含义:返回某日期的月份。 月份是介于 1 到 12 之间的整数。
函数用法:MONTH(日期字段)
函数示例:获取表单字段「今天」日期字段时间所在的月数,则可设置公式为MONTH(今天)
,即2023-9-16 10:43返回9。
函数返回值类型:数字。
MINUTE-时间的分钟数
函数含义:返回某日期的分钟数。
函数用法:MINUTE(日期字段)
函数示例:获取表单字段「今天」日期字段当前时间的分钟数,则可设置公式为MINUTE(今天)
,即2023-9-16 10:43返回43。
函数返回值类型:数字。
SECOND-时间的秒数
函数含义:返回某日期的秒数。
函数用法:SECOND(日期字段)
函数示例:获取表单字段「今天」日期字段时间的秒数,则可设置公式为SECOND(今天),即2023-8-12 10:43:26返回26。
函数返回值类型:数字
NOW-现在的时间
函数含义:将返回现在的时间
函数用法:NOW()
函数示例:获取当前时间,则可设置公式为NOW(),返回值当前时间。
函数返回值类型:日期对象。
SYSTEM-现在的时间
函数含义:获取当前时间,同 NOW。
函数用法:SYSTEM()
函数示例:获取当前时间,则可设置公式为SYSTEM(),返回当前时间。
函数返回值类型:日期对象。
TIMESTAMP-日期转为时间戳
函数含义:将日期对象转换成时间戳。精确到毫秒。
函数用法:TIMESTAMP(date)
函数示例:获取表单字段「今天」日期字段的时间戳,则可设置公式为TIMESTAMP(今天),即2023-09-16 10:32:12返回值1636394402000。
函数返回值类型:数字。
TODAY-今天
函数含义:将返回今天日期(精确到天)。
函数用法:TODAY()
函数示例:获取今天的日期,则可设置公式为TODAY(),今天返回值为2023-9-15。
函数返回值类型:日期对象。
WEEKNUM-日期所在月的周数
函数含义:返回特定日期的周数,默认从周二开始。
注意:默认从周二开始。
函数用法:WEEKNUM(日期字段, return_type)
补充说明:
1.日期字段: 必须填写,指定日期。代表一周中的日期。应使用DATE函数输入日期,或者将日期作为其他公式或函数的结果输入。
2.return_type: 可选。一数字,确定星期从哪一天开始。 星期天为1。
函数示例:获取表单字段「今天」在本月的周数,则可设置公示为WEEKNUM(今天, 1)。
函数返回值类型:日期对象。
DATEDIFF-两个日期之间的差值
函数含义:返回两个日期之间的差值。精确度包括 DAY,HOUR,MINUTE,SECOND。
函数用法:DATEDIFF(日期字段1,日期字段2,‘精确度’)
函数示例:获取表单字段中「请假开始日期」以及「请假结束日期」两个日期字段之间的天数;
则可设置公式为DATEDIFF(请假开始日期,请假结束日期)。
函数返回值类型:数字。
MONTH_DIFF-两个时间横跨的月份
函数含义:求两个时间横跨的月份,包含开始以及结束日期所在月份。
函数用法:MONTH_DIFF(日期控件1,日期控件2)
函数示例:获取表单字段中「开始月份」以及「结束月份」两个日期字段之间的月份差值;
则可设置公式为MONTH_DIFF(开始月份,结束月份)。
函数返回值类型:数字。
YEAR_DIFF-两个时间横跨的年份
函数含义:求两个时间横跨的年份,包含开始以及结束日期所在年份。
函数用法:YEAR_DIFF(日期控件1,日期控件2)
函数示例:获取表单字段中「开始日期」以及「结束日期」两个日期字段之间的年份差值;
则可设置公式为YEAR_DIFF(开始日期,结束日期)。
函数返回值类型:数字。
DATE_FORMAT-日期格式化
函数含义:日期字符串格式化为日期。
函数用法:DATE_FORMAT(文本字段,‘yyyy-MM-dd’)
函数示例:将表单「输入时间」字符串字段,按照格式输出至日期字段中;
则可设置公式为DATE_FORMAT(输入时间,‘yyyy-MM-dd’),即输入2023-9-2文本返回值为日期2023-09-02。
函数返回值类型:日期。
DATEDIFF_PRO-返回两个日期之间的天数
函数含义:返回两个日期之间的天数。
函数用法:DATEDIFF_PRO(开始日期,结束日期,是否取绝对值)
注意:在是否取绝对值中是为1否为0。
函数示例:获取表单两个日期字段「开始日期」与「结束日期」之间的差值;
则可设置公式为DATEDIFF_PRO(开始日期,结束日期,1)。
函数返回值类型:数字。
BIRTHDAY_AGE_NUMBER-获取年龄
函数含义:根据出生日期获取年龄。
函数用法:BIRTHDAY_AGE_NUMBER(日期字段)
函数示例:获取表中「出生日期」字段的年龄值;
则可设置公式为BIRTHDAY_AGE_NUMBER(出生日期),返回值3岁。
函数返回值类型:文本。
WEEKOFMONTH-日期所在当月的周数
函数含义:返回特定日期在此月的周数。
函数用法:WEEKOFMONTH(日期字段)
日期字段: 必需。指定日期。代表日期在一月中的周数。应使用DATE函数输入日期,或者将日期作为其他公式或函数的结果输入。
return_type: 数字,日期为这个月的第几周。
函数示例:计算表单日期字段「今天」为本月的第几周,可设置公式为WEEKOFMONTH(今天),返回结果为3。
函数返回值类型:数字。
WEEKDAY-时间所在周第一天或者最后一天
函数含义:获取指定时间所在周的第一天或者最后一天。
函数用法:WEEKDAY(日期字段,firstday,type)
备注 firstday 本周起始天设定,0 是’星期一’ 1 是’星期天’,type为 1是本周最后一天,2 是 本周第一天。
函数示例:获取表单日期字段「今天」在本周的第一天,可设置公式为WEEKDAY(今天,0,2),返回结果为2024-09-16。
函数返回值类型:日期对象。
MONTHDAY-时间所在月第一天或最后一天
函数含义:时间所在月第一天或最后一天。
函数用法:
MONTHDAY(日期字段,类型)
MONTHDAY(日期字段,type),备注 type 为 1 是第一天 2 是最后一天
函数示例:获取表单日期字段「今天」所在月的第一天,MONTHDAY(日期字段,type)。
备注 type 为 1 是第一天 2 是最后一天可设置公式为MONTHDAY(今天,1),返回结果为2024-09-01。
函数返回值类型:日期对象。
TIME_BELONG_HOUR-时间是否在时间段内
函数含义:判断时间是否在时间段内。
函数用法:TIME_BELONG(时间控件,起始时间,结束时间)
时间控件起始和结束时间都 是 “HH:mm” 模式 24 小时制。 比如 06:00 20:00,如果第二个时间小于第一个时间则表示跨天。
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 19:30:35)】,可设置公式为TIME_BELONG(当前时间,‘09:00’,‘20:00’),返回结果为true。
函数返回值类型:布尔(BOOL)。
BEGIN_OF_DAY- 一天开始的时间
函数含义:一天的开始时间。
函数用法:BEGIN_OF_DAY(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 19:36:00)】,可设置公式为BEGIN_OF_DAY(当前时间),返回结果为2024-09-19 00:00:00。
函数返回值类型:日期对象。
BEGIN_OF_LAST_MONTH-上月开始的时间
函数含义:指定月份上月的开始时间。
函数用法:BEGIN_OF_LAST_MONTH(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 13:00:00)】,可设置公式为BEGIN_OF_LAST_MONTH(当前时间),返回结果为2024-08-01 00:00:00。
函数返回值类型:日期对象。
BEGIN_OF_MONTH()指定月份开始的时间
函数含义:指定月份的开始时间。
函数用法:BEGIN_OF_MONTH(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 13:00:00)】,可设置公式为BEGIN_OF_MONTH(当前时间),返回结果为2024-09-01 00:00:00。
函数返回值类型:日期对象。
BEGIN_OF_NEXT_MONTH-下月开始的时间
函数含义:指定月份下月的开始时间。
函数用法:BEGIN_OF_NEXT_MONTH(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 13:00:00)】,可设置公式为BEGIN_OF_NEXT_MONTH(当前时间),返回结果为2024-10-01 00:00:00。
函数返回值类型:日期对象。
BEGIN_OF_QUARTER-季度的开始时间
函数含义:季度的开始时间。
函数用法:BEGIN_OF_QUARTER(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 13:00:00)】,可设置公式为BEGIN_OF_QUARTER(当前时间),返回结果为2024-07-01 00:00:00。
函数返回值类型:日期对象。
BEGIN_OF_WEEK- 一周的开始时间
函数含义:一周的开始时间。
函数用法:BEGIN_OF_WEEK(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 13:00:00)】,可设置公式为BEGIN_OF_WEEK(当前时间),返回结果为2024-09-16 00:00:00。
函数返回值类型:日期对象。
END_OF_DAY- 一天的结束时间
函数含义:一天的结束时间。
函数用法:END_OF_DAY(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 13:00:00)】,可设置公式为END_OF_DAY(当前时间),返回结果为2024-09-19 23:59:59。
函数返回值类型:日期对象。
END_OF_LAST_MONTH-上月的结束时间
函数含义:指定月份上月的结束时间。
函数用法:END_OF_LAST_MONTH(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 13:00:00)】,可设置公式为END_OF_LAST_MONTH(当前时间),返回结果为2024-08-31 23:59:59。
函数返回值类型:日期对象。
END_OF_MONTH-月份的结束时间
函数含义:指定月份的结束时间。
函数用法:END_OF_MONTH(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 13:00:00)】,可设置公式为END_OF_MONTH(当前时间),返回结果为2024-09-30 23:59:59。
函数返回值类型:日期对象。
END_OF_NEXT_MONTH-月份下月的结束时间
函数含义:指定月份下月的结束时间。
函数用法:END_OF_NEXT_MONTH(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 13:00:00)】
可设置公式为END_OF_NEXT_MONTH(当前时间),返回结果为2024-10-31 23:59:59。
函数返回值类型:日期对象。
END_OF_QUARTER-季度的结束时间
函数含义:指定月份季度的结束时间。
函数用法:END_OF_QUARTER(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 13:00:00)】,可设置公式为END_OF_QUARTER(当前时间),返回结果为2024-09-30 23:59:59。
函数返回值类型:日期对象。
END_OF_WEEK- 一周的结束时间
函数含义:一周的结束时间。
函数用法:END_OF_WEEK(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 13:00:00)】,可设置公式为END_OF_WEEK(当前时间),返回结果为2024-09-22 23:59:59。
函数返回值类型:日期对象。
COUNT_MONTH_DAY-月份有多少天
函数含义:月份有多少天。
函数用法:COUNT_MONTH_DAY(日期字段)
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 )】,可设置公式为COUNT_MONTH_DAY(当前时间),返回结果为30。
函数返回值类型:数字。
DAY_OF_WEEK-当前周的周几
函数含义:返回时间为当前周的周几。
函数用法:DAY_OF_WEEK(日期控件))
函数示例:表单中存在日期控件名为【当前时间(2024-09-19 )】,可设置公式为DAY_OF_WEEK(当前时间),返回结果为4。
函数返回值类型:数字。
TEXT_TIEM_STRING-把数字转化为时间字符串
函数含义:把时间(数字)转为时间字符串。
函数用法:TEXT_TIME_STRING(数字)
数字会进行取绝对值,时间单位为秒。
函数示例:表单中存在数字3600,单位为秒,可设置公式为TEXT_TIME_STRING(3600),返回结果为1小时。
函数返回值类型:文本。
TEXT_TIEM_RANGE_STRING-对文本进行转化
函数含义:对两个时间的差进行时间显示。
函数用法:TEXT_TIME_RANGE_STRING(结束日期,开始日期)
第一个参数为 结束日期,第二个参数为开始日期。如果有一个出现空值,返回 N/A 错误;
两个时间差值会求绝对值,然后进行转化。
函数示例:表单中存在日期控件名为【开始时间(2024-09-19 18:40:00 )】【结束时间(2024-09-19 20:40:00 )】可设置公式为TEXT_TIME_RANGE_STRING(2024-09-19 20:40:00 ,2024-09-19 18:40:00) 返回结果为 2 小时。
函数返回值类型:文本。