更新日期
1. 日期转换函数
1.1 DATE 函数
功能说明 :DATE 函数用于将时间戳转换为日期对象。
语法格式 :
DATE(时间戳)
示例 :
DATE("2025-11-25")
返回:Wed Jan 01 2025 00:00:00 GMT+0800。(此情形下服务器时间为北京时间)
体验 :点击体验该函数

1.2 TIMESTAMP 函数
功能说明 :TIMESTAMP 函数用于将日期对象转换为时间戳。
语法格式 :
TIMESTAMP(日期时间)
示例 :
TIMESTAMP("2025-11-25")
返回:1764000000000。
体验 :点击体验该函数

1.3 TIME 函数
功能说明 :TIME 函数用于将时、分、秒转换为一天中的时间小数值(0–1之间)。例如,在 24 小时制中:12:00 对应 0.5;06:00 对应 0.25;18:00 对应 0.75。
参数说明 :
- 时 :指定小时数。超过 23 时,会按 24 小时制进行进位计算。
- 分 :指定分钟数。超过 59 时,会自动进位为小时。
- 秒 :指定秒数。超过 59 时,会自动进位为分钟。
语法格式 :
TIME(时,分,秒)
示例 :
TIME(4,40,55)
返回:0.195081018518519。
体验 :点击体验该函数

2. 日期差值函数
2.1 DATEDELTA 函数
功能说明 :DATEDELTA 函数用于在指定日期基础上增加或减少天数,并返回新的日期。返回至日期时间字段。
语法格式 :
DATEDELTA(指定日期,需要加减的天数)
示例 :
DATEDELTA(借书日期,借阅周期)
借书日期为 2025-09-08,借阅周期为 30,返回最晚归还日期为:2025-10-08。
体验 :点击体验该函数

2.2 DATEDIF 函数
功能说明 :DATEDIF 函数用于计算两个日期或时间之间的差值,支持按年、月、日、小时、分钟和秒进行计算。
语法格式 :
DATEDIF(开始时间,结束时间,[单位])
单位说明 :
| 参数 | 含义 |
|---|---|
| y | 相差年数 |
| M | 相差月数 |
| d | 相差天数 |
| h | 相差小时数 |
| m | 相差分钟数 |
| s | 相差秒数 |
示例 :
DATEDIF(下单时间,支付时间,"h")
若下单时间为 09:00,支付时间为 10:30,返回:1.5。
体验 :点击体验该函数

2.3 DAYS 函数
功能说明 :DAYS 函数用于计算两个日期之间相差的天数。可返回至单行文本/数字输入框字段。
语法格式 :
DAYS(开始时间,结束时间)
示例 :
DAYS("2025-10-31","2025-11-25")
开始日期为 2025-10-31,结束日期为 2025-11-25,返回两个日期之间的天数:26。
体验 :点击体验该函数

2.4 DAYS360 函数
功能说明 :DAYS360 函数按照每月 30 天、每年 360 天的规则计算日期间隔,常用于财务结算、利息计算等场景。
语法格式 :
DAYS360(开始时间,结束时间)
示例 :
DAYS360("2025-01-01","2025-12-31")
返回:360。
体验 :点击体验该函数

2.5 NETWORKDAYS 函数
功能说明 :NETWORKDAYS 函数用于计算两个日期之间的工作日天数,自动排除周末,并支持指定额外排除日期。
语法格式 :
NETWORKDAYS(开始时间,结束时间,[排除日期列表])
示例一 :
NETWORKDAYS(生产日期,交货日期)
生产日期为 2025-10-20,交货日期为 2025-10-27,返回两个日期间的工作日天数:6。
示例二 :
NETWORKDAYS(生产日期,交货日期,休息日)
若休息日为 2025-10-24,返回两个日期间的工作日天数:5。
体验 :点击体验该函数

2.6 WORKDAY 函数
功能说明 :WORKDAY 函数用于根据指定日期推算增加或减少若干工作日后的日期,自动排除周末及指定日期。默认不包含开始日期当天。
语法格式 :
WORKDAY(日期,工作日数,[排除日期列表])
示例一 :
WORKDAY(企业认证提交日期,处理时长)
提交日期为 2025-02-06,处理时长为 7,返回:2025-02-17。
示例二 :
WORKDAY(企业认证提交日期,处理时长,DATE(2025,2,13))
返回:2025-02-18。
体验 :点击体验该函数

3. 当前时间函数
3.1 NOW 函数
功能说明 :NOW 函数用于获取当前日期和时间。返回至日期时间字段。
语法格式 :
NOW()
示例 :
NOW()
返回当前日期和时间。
体验 :点击体验该函数

3.2 TODAY 函数
功能说明 :TODAY 函数用于获取当前日期。返回至日期时间字段。
语法格式 :
TODAY()
示例 :
TODAY()
返回当前日期。
体验 :点击体验该函数

3.3 SYSTIME 函数
功能说明 :SYSTIME 函数用于获取服务器当前时间。返回结果以服务器所在时区时间为准,可能与客户端本地时间存在差异。
语法格式 :
SYSTIME()
示例 :
SYSTIME()
返回当前服务器时间。
体验 :点击体验该函数

4. 日期提取函数
4.1 YEAR 函数
功能说明 :YEAR 函数用于从日期中提取年份。
语法格式 :
YEAR(日期时间)
示例 :
YEAR("2025-11-25")
返回:2025。
体验 :点击体验该函数

4.2 MONTH 函数
功能说明 :MONTH 函数用于提取日期中的月份(1-12)。
语法格式 :
MONTH(日期时间)
示例 :
MONTH("2025-11-25")
返回:11。
体验 :点击体验该函数

4.3 DAY 函数
功能说明 :DAY 函数用于提取日期中的日(1-31)。
语法格式 :
DAY(日期时间)
示例 :
DAY("2025-11-25")
返回:25。
体验 :点击体验该函数

4.4 HOUR 函数
功能说明 :HOUR 函数用于提取日期时间中的小时数(0-23)。注意,此处作为变量的日期时间函数类型需要选择“年-月-日 时:分”或“年-月-日 时:分:秒”。
语法格式 :
HOUR(日期时间)
示例 :
HOUR("2025-02-28 06:00")
返回:6。
体验 :点击体验该函数

4.5 MINUTE 函数
功能说明 :MINUTE 函数用于提取日期时间中的分钟数(0-59)。注意,此处作为变量的日期时间函数类型需要选择“年-月-日 时:分”或“年-月-日 时:分:秒”。
语法格式 :
MINUTE(日期时间)
示例 :
MINUTE("2025-02-22 09:32")
返回:32。
体验 :点击体验该函数

4.6 SECOND 函数
功能说明 :SECOND 函数用于提取日期时间中的秒数(0-59)。注意,此处作为变量的日期时间函数类型需要选择“年-月-日 时:分:秒”。
语法格式 :
SECOND(日期时间)
示例 :
SECOND("2025-11-25 20:05:10")
返回:10。
体验 :点击体验该函数

5. 星期与周期函数
5.1 WEEKDAY 函数
功能说明 :WEEKDAY 函数用于获取指定日期对应的星期值,可用于判断工作日、周末或进行周期性统计。可返回至单行文本/数字输入框字段。
语法格式 :
WEEKDAY(日期时间)
示例 :
WEEKDAY("2025-11-25")
返回:2,表示星期二。
体验 :点击体验该函数

5.2 WEEKNUM 函数
功能说明 :WEEKNUM 函数用于计算指定日期在当年属于第几周。返回至单行文本/数字输入框字段。
语法格式 :
WEEKNUM(日期时间)
示例 :
WEEKNUM("2025-11-25")
返回:48,表示该日期位于当年的第 48 周。
体验 :点击体验该函数

5.3 ISOWEEKNUM 函数
功能说明 :ISOWEEKNUM 函数用于按照 ISO 8601 标准计算指定日期属于当年的第几周。
语法格式 :
ISOWEEKNUM(日期时间)
示例 :
ISOWEEKNUM("2025-11-25")
返回:48,表示该日期位于 ISO 标准定义下的第 48 周。
体验 :点击体验该函数

6. 注意事项
- 部分函数(如 HOUR()、MINUTE()、SECOND())需要传入包含时间信息的日期时间值。若字段仅包含日期,不包含时、分、秒,则可能无法获得预期结果。
- NOW()、TODAY()、SYSTIME() 返回的结果会随当前时间变化而变化,同一公式在不同时间执行时,结果可能不同。
- SYSTIME() 获取的是服务器时间。服务器时区与客户端所在地不同时,显示结果可能存在差异,应以实际返回结果为准。
- NETWORKDAYS() 和 WORKDAY() 默认排除周六、周日。如需排除法定节假日或其他休息日期,可通过排除日期参数进行设置。
- WORKDAY() 默认不包含开始日期当天,计算结果从下一个工作日开始。
- DATEDIF() 在省略第三个参数时,默认按照天数(d)计算两个日期之间的差值。
- DAYS360() 按每月 30 天、每年 360 天进行计算,其结果可能与实际自然日间隔不同,适用于财务结算、利息计算等场景。
- WEEKNUM() 与 ISOWEEKNUM() 的周数计算规则不同,同一日期返回的结果可能不一致。涉及周统计时,建议统一使用一种计算方式。
- DATE() 与 TIMESTAMP() 使用的时间戳单位应保持一致。若秒级时间戳与毫秒级时间戳混用,可能导致转换结果异常。
- DAYS()、DATEDIF()、NETWORKDAYS() 等函数的计算结果受系统日期计算规则影响,涉及边界日期时,建议先进行实际测试确认结果。