# 日期函数 [TOC] ## \=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(datetime2("19800227","yyyyMMdd")) 返回：1980 例2：=year("1972-11-08 10:20:30") 返回：1972 例3：=year(dateTime("2006-01-15 13:20:45")) 返回：2006 例4：使用数据集或单元格 集合：=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) ## \=day() 1. 函数说明： 从日期型数据中获得该日在本月中是几号 2. 语法：day(dateExp) 3. 参数说明： dateExp 表达式，其结果必须为日期或标准日期格式的字符串，如yyyy-MM-ddHH:mm:ss，yyyy- MM-dd，HH:mm:ss 4. 返回值： 整数 5. 示例： 例1：=day(datetime2("19800227","yyyyMMdd")) 返回：27 例2：=day(dateTime(12345)) 返回：1 例3：=day(dateTime("2006-01-15 10:20:30")) 返回：15 例4：使用数据集或单元格 集合：=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}") | 预览页面：