日期函数丨三叠云插图

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: 必需,时间戳

返回值:

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

示例

日期函数丨三叠云插图1

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

日期函数丨三叠云插图2

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

日期函数丨三叠云插图3

2.2 TIME函数

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

入参:

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

返回值:

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

示例

日期函数丨三叠云插图4

复合函数案例:

日期函数丨三叠云插图5

输出的数值:

日期函数丨三叠云插图6

2.3 TIMESTAMP函数

表达式:TIMESTAMP(date)

入参:

  • 赋值给日期组件

返回值:

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

示例

日期函数丨三叠云插图7

实现效果:

日期函数丨三叠云插图8

2.4 TODAY函数

表达式:TODAY()

返回值:

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

示例

日期函数丨三叠云插图9

2.5 NOW函数

表达式:NOW()

返回值:

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

2.6 SYSTIME函数

表达式:SYSTIME()

返回值:

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

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

示例

日期函数丨三叠云插图10

2.7 DAY函数

表达式:DAY(date)

入参:

  • 指定日期

返回值:

  • 类型:数值
  • 返回值规则:返回日期天数(天数是介于 1 到 31 之间的整数)

示例

日期函数丨三叠云插图11

实现效果:

日期函数丨三叠云插图12

2.8 MONTH函数

表达式:MONTH(date)

入参:

  • 指定日期

返回值:

  • 类型:数值
  • 返回值规则:返回日期月份(月份是介于 1 到 12 之间的整数)

示例

日期函数丨三叠云插图13

实现效果:

日期函数丨三叠云插图14

2.9 YEAR函数

表达式:YEAR(date)

入参:

  • 指定日期

返回值:

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

示例

日期函数丨三叠云插图15

实现效果:

日期函数丨三叠云插图16

2.10 HOUR函数

表达式:HOUR(date)

入参:

  • 日期组件

返回值:

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

示例

日期函数丨三叠云插图17

实现效果:

日期函数丨三叠云插图18

2.11 MINUTE函数

表达式:MINUTE(date)

入参:

  • 指定日期

返回值:

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

示例

日期函数丨三叠云插图19

实现效果:

日期函数丨三叠云插图20

2.12 SECOND函数

表达式:SECOND(date)

入参:

  • 指定日期

返回值:

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

示例

日期函数丨三叠云插图21

实现效果:

日期函数丨三叠云插图22

2.13 DAYS函数

表达式:DAYS(end_date, start_date)

入参:

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

返回值:

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

示例

日期函数丨三叠云插图23

实现效果:

日期函数丨三叠云插图24

2.14 DAYS360函数

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

入参:

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

返回值:

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

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

示例:

日期函数丨三叠云插图25

2.15 DATEDELTA函数

表达式:DATEDELTA(date, delta_days)

入参:

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

返回值:

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

示例:

日期函数丨三叠云插图26

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

2.16 WEEKNUM函数

表达式:WEEKNUM(date, return_type)

入参:

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

返回值:

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

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

示例:

日期函数丨三叠云插图27

2.17 IOSWEEKNUM函数

表达式:ISOWEEKNUM(date)

入参:

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

返回值:

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

示例

日期函数丨三叠云插图28