1. 概述
1.1 版本
| FineBI版本 | JAR 包 | 功能变动 |
|---|---|---|
| 5.1 | - | - |
| 5.1.7 | 2020-11-05 | 函数释义优化&明确函数参数合法性 |
| 5.1.11 | 2021-04-02 | 实时数据公式校验加强 |
| 5.1.12 | - | 抽取数据公式校验加强&新增 QUARTER 函数 |
1.2 使用范围
| 使用位置 | |
|---|---|
| 自助数据集 | 新增列、过滤 |
| 仪表板 | 添加计算字段 |
注：函数中以日期作为参数因子的，其中日期的形式都必须是 yyyy/mm/dd 或 yyyy-MM-dd 。而且必须用英文环境下双引号(" ")引用。
1.3 常用日期公式
文档提供了一些常用的日期组合公式，方便用户直接使用，详情参见：常用日期公式 。
2. 函数列表
| 函数 | 说明 |
|---|---|
| MONTH-日期中的月份 | 返回日期中的月。月是介于1和12之间的一个数。 |
| YEAR-返回年份 | 返回日期中的年。year是介于1900和9999之间的一个数。 |
| DAY-日期中的日 | 返回日期中的日。DAY是介于1和31之间的一个数。 |
| DAYSOFYEAR-一年的天数 | 返回某年包含的天数 |
| MONTHDELTA-返回后几个月日期 | 返回指定日期date后delta个月的日期。 |
| DATEDIF-日期差 | 返回两个指定日期间的天数、月数或年数。 |
| DATEDELTA-返回后几天日期 | 返回一个日期date后deltadays的日期。 |
| WEEKDATE-指定周周几日期 | 返回指定年月的指定周的周几的具体日期。 |
| DAYS360-天数差(360天) | 按照一年360天的算法（每个月以30天计，一年共计12个月），返回两日期间相差的天数，这在会计计算中将会用到。如果财务系统是基于一年12个月，每月30天，可用此函数帮助计算支付款项。 |
| TODATE-转换为日期类型 | 函数可以将各种日期形式的参数转换为日期类型。 |
| LUNAR-农历日期 | 返回当前日期对应的农历时间 |
| MINUTE-分钟数 | 返回某一指定时间的分钟数，其值是介于0与59之间的一个整数 |
| DAYSOFMONTH-某月天数 | 返回从1900年1月后某年某月包含的天数。 |
| DATESUBDATE-日期时间差 | 返回两个日期之间的时间差。 |
| DATETONUMBER-经过毫秒数 | 返回自1970年1月1日00:00:00GMT经过的毫秒数。 |
| DAYVALUE-天数（1900起） | 返回 1900 年至 date 日期所经历的天数。 |
| DATE-显示日期 | 返回一个表示某一特定日期。 |
| NOW-当前时间 | 获取当前时间 |
| HOUR-小时数 | 返回某一指定时间的小时数。函数指定HOUR为0（0:00）到23（23:00)之间的一个整数。 |
| YEARDELTA-某日期后几年 | 返回指定日期后delta年的日期。 |
| DAYSOFQUARTER-某季度天数 | 返回从 1900 年 1 月后某年某季度的天数 |
| WEEK-求周数 | 返回一个代表一年中的第几周的数字 |
| WEEKDAY-星期数 | 获取日期并返回星期数。返回值为介于0到6之间的某一整数，分别代表星期中的某一天（从星期日到星期六）。 |
| TODAY-当前日期 | 是获取当前的日期。 |
| TIME-时间 | 返回代表指定时间的小数 |
| SECOND-秒数 | 返回某一指定时间的秒数，其值是介于0与59之间的一个整数。 |
| QUARTER-季度 | 返回时间所在季度，若无参数则返回当前服务器时间所在季度 |
