跳到主要内容

日期函数

=date()​

  1. 函数说明： 将字符串转换成日期型数据
  2. 语法： date(stringExp)
  3. 参数说明： stringExp 字符串表达式，其结果必须返回合法日期格式的字符串 要求格式为yyyy-MM-dd，不含时间，如果含了时间，时间部分不转换
  4. 返回值： 日期时间型，但是时间部分都为00:00:00
  5. 示例：
  • 例1：=date("1982-08-09") 返回日期：1982-08-09 00:00:00
  • 例2：=date("1982-08-09 10:20:30") 返回日期：1982-08-09 00:00:00
  • 例3：使用数据集或单元格
    • 集合：=date('#{jm.create_time}')
    • 对象：=date('${jm.create_time}')
    • 单元格：=date(A1)

=time()​

  1. 函数说明： 将字符串转换成时间型数据
  2. 语法：time(stringExp)
  3. 参数说明： stringExp HH:mm:ss格式的字符串 返回值： 时间型数据
  4. 示例：使用数据集或单元格
  • 集合：=time('#{jm.create_time}')
  • 对象：=time('${jm.create_time}')
  • 单元格：=time(A1)

=now()​

  1. 函数说明： 获得系统此刻的日期时间，返回
  2. 语法：now()
  3. 返回值： 长整型数值
  4. 需要在设计页面配置单元格的时间格式：

=year()​

  1. 函数说明： 从日期型数据中获得年信息
  2. 语法： year(dateExp)
  3. 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
  4. 返回值： 整数
  5. 示例：
  • 例1：=year("1972-11-08 10:20:30") 返回：1972
  • 例2：使用数据集或单元格
    • 集合：=year('#{jm.create_time}')
    • 对象：=year('${jm.create_time}')
    • 单元格：=year(A1)

=month()​

  1. 函数说明： 取得指定日期所在的月份
  2. 语法：month(dateExp)
  3. 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
  4. 返回值： 整数
  5. 示例：
  • 例1：=month("1972-11-08 10:20:30") 返回：11
  • 例2：使用数据集或单元格
    • 集合：=month('#{jm.create_time}')
    • 对象：=month('${jm.create_time}')
    • 单元格：=month(A1)

注意当month()函数的返回值是整数，该函数会去掉前面的0。eg. =month("2006-01-01 10:20:30") 返回：1；如果需要不去零的可以使用month2函数

=month2()​

版本支持version 1.7.5+ date 20240509

  1. 函数说明： 取得指定日期所在的月份(不去零）
  2. 语法：month2(dateExp)
  3. 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss
  4. 返回值： 字符串
  5. 示例：
  • 例1：=month2("1972-11-08 10:20:30") 返回：11
  • 例2：使用数据集或单元格
    • 集合：=month2('#{jm.create_time}')
    • 对象：=month2('${jm.create_time}')
    • 单元格：=month2(A1)

=day()​

  1. 函数说明： 从日期型数据中获得该日在本月中是几号
  2. 语法：day(dateExp)
  3. 参数说明： dateExp 表达式，其结果必须为日期或标准日期格式的字符串，如yyyy-MM-ddHH:mm:ss，yyyy- MM-dd，HH:mm:ss
  4. 返回值： 整数
  5. 示例：
  • 例1：=day("2006-01-15 10:20:30") 返回：15
  • 例2：使用数据集或单元格
    • 集合：=day('#{jm.create_time}')
    • 对象：=day('${jm.create_time}')
    • 单元格：=day(A1)

注意当day()函数的返回值是整数，该函数会去掉前面的0。eg. =day("2006-01-01 10:20:30") 返回：1；如果需要不去零的可以使用day2函数

=day2()​

版本支持version 1.7.5+ date 20240509

  1. 函数说明： 从日期型数据中获得该日在本月中是几号（不去零）
  2. 语法：day(dateExp)
  3. 参数说明： dateExp 表达式，其结果必须为日期或标准日期格式的字符串，如yyyy-MM-ddHH:mm:ss，yyyy- MM-dd，HH:mm:ss
  4. 返回值： 字符串
  5. 示例：
  • 例1：=day("2006-01-15 10:20:30") 返回：15
  • 例2：使用数据集或单元格
    • 集合：=day('#{jm.create_time}')
    • 对象：=day('${jm.create_time}')
    • 单元格：=day(A1)

=nowstr()​

  1. 函数说明：返回当前时间
  2. 返回值： 字符串
  3. 示例： =nowstr() 返回结果 2021-07-28 16:31:30

上述说明表达式传参都是固定一个值，下面示例传递数据集参数： 设计页面：

格式化后时间列 操作截图：

后续列填充值为：

列内容
date=date("#{test.create_time}")
time=time("#{test.create_time}")
day=day("#{test.create_time}")
month=month("#{test.create_time}")
year=year("#{test.create_time}")
预览页面：

=hour()​

版本支持version 1.6.7+ date 20231229

  1. 函数说明： 从日期型数据中获得小时信息
  2. 语法： hour(dateExp)
  3. 参数说明： dateExp 时间或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss或 HH:mm:ss
  4. 返回值： 整数
  5. 示例：
  • 例1：=hour("1972-11-08 10:20:30") 返回：10
  • 例2：=hour("13:20:45") 返回：13
  • 例3：使用数据集或单元格
    • 集合：=hour('#{jm.create_time}')
    • 对象：=hour('${jm.create_time}')
    • 单元格：=hour(A1)

注意当hour()函数的返回值是整数，该函数会去掉前面的0。eg. =day("2006-01-01 10:20:30") 返回：1；如果需要不去零的可以使用hour2函数

=hour2()​

版本支持version 1.7.5+ date 20240509

  1. 函数说明： 从日期型数据中获得小时信息
  2. 语法： hour2(dateExp)
  3. 参数说明： dateExp 时间或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss或 HH:mm:ss
  4. 返回值： 字符串
  5. 示例：
  • 例1：=hour2("1972-11-08 10:20:30") 返回：10
  • 例2：=hour2("13:20:45") 返回：13
  • 例3：使用数据集或单元格
    • 集合：=hour2('#{jm.create_time}')
    • 对象：=hour2('${jm.create_time}')
    • 单元格：=hour2(A1)

=minute()​

版本支持version 1.9.2+ date 20241216

  1. 函数说明： 从日期型数据中获得小时信息
  2. 语法： hour(dateExp)
  3. 参数说明： dateExp 时间或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss或 HH:mm:ss
  4. 返回值： 整数
  5. 示例：
  • 例1：=minute("1972-11-08 10:09:30") 返回：9
  • 例2：=minute("13:09:45") 返回：9
  • 例3：使用数据集或单元格
    • 集合：=minute('#{jm.create_time}')
    • 对象：=minute('${jm.create_time}')
    • 单元格：=minute(A1)

注意：当minute()函数的返回值是整数，该函数会去掉前面的0。eg. =day("2006-01-01 10:01:30") 返回：1；如果需要不去零的可以使用minute2函数

=minute2()​

版本支持version 1.9.2+ date 20241216

  1. 函数说明： 从日期型数据中获得小时信息
  2. 语法： minute2(dateExp)
  3. 参数说明： dateExp 时间或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss或 HH:mm:ss
  4. 返回值： 字符串
  5. 示例：
  • 例1：=minute2("1972-11-08 10:09:30") 返回：09
  • 例2：=minute2("13:09:45") 返回：09
  • 例3：使用数据集或单元格
    • 集合：=minute2('#{jm.create_time}')
    • 对象：=minute2('${jm.create_time}')
    • 单元格：=minute2(A1)