1. 日期函数简介

• DATE
• TIME
• TIMESTAMP
• TODAY
• NOW
• SYSTIME
• DAY
• MONTH
• YEAR
• HOUR
• MINUTE
• SECOND
• DAYS
• DAYS360
• DATEDIF
• DATEDELTA
• WEEKNUM
• ISOWEEKNUM

日期组件的返回值为时间戳（timestamp），单位是毫秒；以下日期函数的参数可以直接使用日期组件。例如：YEAR (日期组件)

下面介绍关于日期函数的两个基本概念：

时间戳（TIMESTAMP）：时间戳是计算机记录时间的一种格式。通常是一个字符序列，唯一地标识某一刻的时间。在宜搭表单中，「日期」组件便是由这样的序列来存储的

日期对象：可以理解为年月日时分秒；日期对象的格式为 Sat Aug 01 2021 00:00:00 GMT 0800（中国标准时间），即北京时间 2021 年 8 月 1 日 00:00:00，日期对象可以进行各种运算，比如日期加减法等

2. 公式示例

2.1 DATE函数

表达式：DATE(timestamp)

入参：

• timestamp: 必需，时间戳

返回值：

• 类型：日期对象
• 返回值规则：将时间戳转换为日期对象（用来将日期组件的时间戳转为日期对象进行日期公式运算）

示例

注释：把「申请日期」这个时间组件中的存储的“时间戳”值，转化为文本值填入「申请日期-文本」（单行文本）中。

支持的占位符(注意大小写)：

2.2 TIME函数

表达式：TIME(hour, minute, second)

入参：

• hour：小时
• minute：分钟
• second：秒数

返回值：

• 类型：数值
• 返回值规则：返回特定时间的十进制数字。时间值为日期值的一部分，并用十进制数表示

示例

复合函数案例：

输出的数值：

2.3 TIMESTAMP函数

表达式：TIMESTAMP(date)

入参：

• 赋值给日期组件

返回值：

• 类型：日期
• 返回值规则：将日期对象转换成时间戳,主要用来将日期公式计算出的日期对象转为时间戳，给日期组件赋值

示例

实现效果：

2.4 TODAY函数

表达式：TODAY()

返回值：

• 类型：日期
• 返回值规则：得出今天的日期

示例

2.5 NOW函数

表达式：NOW()

返回值：

• 类型：日期
• 返回值规则：将当前日期赋值给日期组件

2.6 SYSTIME函数

表达式：SYSTIME()

返回值：

• 类型：日期
• 返回值规则：自动获取当前服务器时间

注：即使客户端的时间被人为调整了，SYSTIME 函数不受影响，获取的仍然是服务器时间。例如签到、打卡等场景下，可避免调整时间作弊的情况。

示例

2.7 DAY函数

表达式：DAY(date)

入参：

• 指定日期

返回值：

• 类型：数值
• 返回值规则：返回日期天数（天数是介于 1 到 31 之间的整数）

示例

实现效果：

2.8 MONTH函数

表达式：MONTH(date)

入参：

• 指定日期

返回值：

• 类型：数值
• 返回值规则：返回日期月份（月份是介于 1 到 12 之间的整数）

示例

实现效果：

2.9 YEAR函数

表达式：YEAR(date)

入参：

• 指定日期

返回值：

• 类型：数值
• 返回值规则：返回日期年份

示例

实现效果：

2.10 HOUR函数

表达式：HOUR(date)

入参：

• 日期组件

返回值：

• 类型：数值
• 返回值规则：返回日期小时数

示例

实现效果：

2.11 MINUTE函数

表达式：MINUTE(date)

入参：

• 指定日期

返回值：

• 类型：数值
• 返回值规则：返回日期分钟数

示例

实现效果：

2.12 SECOND函数

表达式：SECOND(date)

入参：

• 指定日期

返回值：

• 类型：数值
• 返回值规则：返回日期秒数

示例

实现效果：

2.13 DAYS函数

表达式：DAYS(end_date, start_date)

入参：

• end_date: 必需。结束日期。
• start_date: 必需。起始日期。

返回值：

• 类型：数值
• 返回值规则：得出日期之间天数

示例

实现效果：

2.14 DAYS360函数

表达式：DAYS360(end_date, start_date, method)

入参：

• end_date: 必需。结束日期。
• start_date: 必需。起始日期。
• method: 可选。用于指定在计算中是采用美国方法还是欧洲方法。不填或 false 表示是美国方法，true 表示是欧洲方法。

返回值：

• 类型：数值
• 返回值规则：返回 2 个日期相差天数

公式目的：按照一年 360 天的算法（每个月以 30 天计，一年共计 12 个月），DAYS360 函数返回两个日期间相差的天数，这在一些会计计算中将会用到。 如果财会系统是基于一年 12 个月，每月 30 天，可使用此函数帮助计算支付款项。

示例：

2.15 DATEDELTA函数

表达式：DATEDELTA(date, delta_days)

入参：

• date: 必需。初始日期。
• delta_days: 必需。需要加减的天数。正数为增加，负数为减少。

返回值：

• 类型：日期
• 返回值规则：自动返回指定加/减天数后的日期时间

示例：

注解：在「开始时间」基础上，添加12天作为「结束时间」

2.16 WEEKNUM函数

表达式：WEEKNUM(date, return_type)

入参：

• data: 必需。指定日期。代表一周中的日期。应使用 DATE 函数输入日期，或者将日期作为其他公式或函数的结果输入
• return_type: 可选。一数字，确定星期从哪一天开始，默认值为 1。 数字1为周日开始，数字2为周一开始，当前只支持数字1和2。

返回值：

• 类型：数值
• 返回值规则：返回日期周数

公式目的：返回特定日期的周数。例如，包含 1 月 1 里的周为该年的第 1 周，其编号为第 1 周。

示例：

2.17 IOSWEEKNUM函数

表达式：ISOWEEKNUM(date)

入参：

• data: 必需。日期是 Ecxel 用于日期和时间计算的日期-时间代码

返回值：

• 类型：数值
• 返回值规则：返回日期周数

示例