1. 概述
在进行数据分析时，经常需要对某个数据进行格式调整的情形，在 FineBI 中有一个专门进行格式调整的函数：FORMAT。
| 语法 | FORMAT(object,format) | 返回 object 的 format 格式 |
|---|---|---|
| 参数1 | object | 需要被格式化对象，可以是 String ，数字，Object (常用的有Date, Time)。注：实时数据只支持日期类型。 |
| 参数2 | format | 格式化的样式 |
2. 注意事项
可使用两个参数，抽取数据第一个参数为任意类型，第二个参数类型为文本
实时数据中第一个参数为日期类型，第二个参数为文本类型。
FORMAT 对日期的操作，日期的大小写必须按照年份小写 yy 或 yyyy，月份大写 M 或 MM，日期小写 d 或 dd。
[直连]Kyligence企业版 数据库不支持该函数。
3. 示例
下文列出了常用的格式参数，包括日期格式和数据格式。
以 2021-06-15 时间为例。
3.1 日期时间格式参数
| 格式参数 | 输出 |
|---|---|
| D | 166 |
| DD | 166 |
| M | 6 |
| MM | 06 |
| MMM | 六月 |
| MMMM | 六月 |
| YY | 21 |
| YYYY | 2021 |
| YYYYMM | 202106 |
| MM/dd/yyyy | 06/15/2021 |
| M-d-yy | 6-15-21 |
| EEEEE, MMMMM dd, yyyy | 星期二, 六月 15, 2021 |
| h:mm:ss a | 12:00:00 上午 |
例如，需要去掉日期字段的小时数据。
创建新增公式列，命名并输入公式：TODATE(FORMAT(ingestTime,"yyyy-MM-dd"))。得到结果如下图所示：
3.2 数值格式参数
以 1234.56 为例。
| 参数格式 | 公式 | 输出 |
|---|---|---|
| #,##0.00 | FORMAT(1234.5, "#,##0.00") | 1234.50 |
| "#,##0 | FORMAT(1234.5, "#,##0") | 1234 |
| ￥#,##0.00 | FORMAT(1234.5, "￥#,##0.00") | ￥1234.50 |
| 0% | FORMAT(1.5, "0%") | 150% |
| 0.000% | FORMAT(1.5, "0.000%") | 150.000% |
| ##0.0E0 | FORMAT(6789, "##0.0E0") | 6.789E3 |
| 0.00E00 | FORMAT(6789, "0.00E00") | 6.79E03 |
3.3 其他组合函数使用
| 公式 | 结果 | 备注 |
|---|---|---|
| FORMAT(date(2007,1,1), "EEEEE, MMMMM dd, yyyy") | 星期一，一月 01，2007 | |
| FORMAT(date(2007,1,13), "MM/dd/yyyy") | 01/13/2007 | |
| FORMAT(date(2007,1,13), "M-d-yy") | 1-13-07 | |
| FORMAT(time(16,23,56), "h:mm:ss a") | 4:23:56 下午 |
