3.日期公式

689 上次更新时间:2024-09-24 10:29:52

Document

日期公式简介

日期时间字段 的返回值为时间戳(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 小时。

函数返回值类型:文本。