luckysheet/docs/zh/guide/format.md

# 格式属性

## 单元格属性表

<table>
    <tr>
        <td>属性值</td>
        <td>全称</td>
        <td><div style="width:100px">说明</div></td>
        <td>值示例</td>
        <td>Aspose方法或者属性</td>
    </tr>
    <tr>
        <td>ct</td>
        <td>celltype</td>
        <td>单元格值格式：文本、时间等</td>
        <td><a href="#cellStyle">单元格格式</a></td>
        <td></td>
    </tr>
    <tr>
        <td>bg</td>
        <td>background</td>
        <td>背景颜色</td>
        <td>#fff000</td>
        <td>setBackgroundColor</td>
    </tr>
    <tr>
        <td>ff</td>
        <td>fontfamily</td>
        <td>字体</td>
        <td>0 微软雅黑、1 宋体（Song）、2 黑体（ST Heiti）、3 楷体（ST Kaiti）、 4仿宋（ST FangSong）、 5 新宋体（ST Song）、 6 华文新魏、 7华文行楷、 8 华文隶书、 9 Arial、 10 Times New Roman 、11 Tahoma 、12 Verdana</td>
        <td>Style.Font object's Name property.</td>
    </tr>
    <tr>
        <td>fc</td>
        <td>fontcolor</td>
        <td>字体颜色</td>
        <td>#fff000</td>
        <td>Style.Font object's Color property</td>
    </tr>
    <tr>
        <td>bl</td>
        <td>bold</td>
        <td>粗体</td>
        <td>0 常规 、 1加粗</td>
        <td>Style.Font object's IsBold property to true.</td>
    </tr>
    <tr>
        <td>it</td>
        <td>italic</td>
        <td>斜体</td>
        <td>0 常规 、 1 斜体</td>
        <td></td>
    </tr>
    <tr>
        <td>fs</td>
        <td>fontsize</td>
        <td>字体大小</td>
        <td>14</td>
        <td>Style.Font object's Size property.</td>
    </tr>
    <tr>
        <td>cl</td>
        <td>cancelline</td>
        <td>删除线</td>
        <td>0 常规 、 1 删除线</td>
        <td>Style.Font object's Underline property</td>
    </tr>
    <tr>
        <td>vt</td>
        <td>verticaltype</td>
        <td>垂直对齐</td>
        <td>0 中间、1 上、2下</td>
        <td>setVerticalAlignment</td>
    </tr>
    <tr>
        <td>ht</td>
        <td>horizontaltype</td>
        <td>水平对齐</td>
        <td>0 居中、1 左、2右</td>
        <td>setHorizontalAlignment</td>
    </tr>
    <tr>
        <td>mc</td>
        <td>mergecell</td>
        <td>合并单元格</td>
        <td>{ rs: 10, cs:5 } 表示从此cell开始到10行5列的cell进行合并。</td>
        <td>Merge</td>
    </tr>
    <tr>
        <td>tr</td>
        <td>textrotate</td>
        <td>文字旋转</td>
        <td>0： 0、1： 45 、2：-45、3 竖排文字、4： 90 、5：-90</td>
        <td>setRotationAngle</td>
    </tr>
    <tr>
        <td>tb</td>
        <td>textbeak</td>
        <td>文本换行</td>
        <td>0 截断、1溢出、2 自动换行</td>
        <td>2：setTextWrapped <br> 0和1：IsTextWrapped =&nbsp;true</td>
    </tr>
    <tr>
        <td>v</td>
        <td>value</td>
        <td>原始值</td>
        <td></td>
        <td></td>
    </tr>
    <tr>
        <td>m</td>
        <td>monitor</td>
        <td>显示值</td>
        <td></td>
        <td></td>
    </tr>
    <tr>
        <td>f</td>
        <td>function</td>
        <td>公式</td>
        <td></td>
        <td>setFormula <br> setArrayFormula <br> workbook.calculateFormula();</td>
    </tr>
</table>


以下为3个单元格存储：
```json
[
    {
        "r": 10,
        "c": 11,
        "v": {
            "f": "=MAX(A7:A9)",
            "ct": {
                "fa": "General",
                "t": "n"
            },
            "v": 100,
            "m": "100"
        }
    },
    {
        "r": 0,
        "c": 1,
        "v": {
            "v": 12,
            "f": "=SUM(A2)",
            "bg": "#fff000"
        }
    },
    {
        "r": 10,
        "c": 11,
        "v": "值2"
    }
]
```

## <div id='cellStyle'>单元格格式</div>

参考[Aspose.Cells](https://docs.aspose.com/display/cellsnet/List+of+Supported+Number+Formats#ListofSupportedNumberFormats-Aspose.Cells)

格式设置为：

```json
{
    "ct": {
        "fa": "General",
        "t": "g"
    },
    "m": "2424",
    "v": 2424
}
```

|参数|说明|值|
| ------------ | ------------ | ------------ |
|fa|Format格式的定义串| 如"General"|
|t|Type类型|如"g"|

可选择的设置如下：
| 格式 | ct.fa  |  ct.t   | m 值示例 |备注 |
|----------|----------|-------------------------|------------------------- |------------------------- |
| 自动        | General    |     g      | Luckysheet ||
| 纯文本      | @    | s                         | Luckysheet ||
| <br><br><br>**数字格式** | | | | |
| 整数      | 0 |     n                     | 1235 | 0位小数 ||
| 数字一位小数        | 0.0 | n  | 1234.6 | 点后面0的个数就代表小数位数,如果原始数字位数大,设置位数小时会做四舍五入 |
| 数字两位小数      | 0.00   | n  | 1234.56 ||
| 百分比整数      | 0%    | n          | 123456% |也支持 #0% 的用法|
| 百分比      | 0.00%     | n          | 123456.00% |也支持 #0.00% 的用法,点后面0的个数就代表小数位数|
| 科学计数    | 0.00E+00    | n        | 1.23E+03 ||
| 科学计数    | ##0.0E+0    | n        | 1.2E+3 ||
| 分数    | # ?/?    | n        | 1234 5/9 ||
| 分数    | # ??/??    | n        | 1234 14/25 ||
| 万元        | w   | n                         |12万3456||
| 万元2位小数  | w0.00   | n                    |12万3456.00|| 
| 会计        | ¥(0.00)   | n                   ||
| 更多数字格式    | #,##0   | n  | 1,235 ||
| 更多数字格式    | #,##0.00   | n  | 1,234.56 ||
| 更多数字格式    | `#,##0_);(#,##0)`   | n  | 1,235 ||
| 更多数字格式    | `#,##0_);[Red](#,##0)`   | n  | 1,235 ||
| 更多数字格式    | `#,##0.00_);(#,##0.00)`   | n  | 1,234.56 ||
| 更多数字格式    | `#,##0.00_);[Red](#,##0.00)`   | n  | 1,234.56 ||
| 更多数字格式    | $#,##0_);($#,##0)   | n  | $1,235 ||
| 更多数字格式    | `$#,##0_);[Red]($#,##0)`   | n  | $1,235 ||
| 更多数字格式    | $#,##0.00_);($#,##0.00)   | n  | $1,234.56 ||
| 更多数字格式    | `$#,##0.00_);[Red]($#,##0.00)`   | n  | $1,234.56 ||
| 更多数字格式    | _($* #,##0_);_(...($* "-"_);_(@_)   | n  | $ 1,235 ||
| 更多数字格式    | _(* #,##0_);_(*..._(* "-"_);_(@_)   | n  | 1,235 ||
| 更多数字格式    | _($* #,##0.00_);_(...($* "-"_);_(@_)   | n  | $ 1,234.56 ||
| 更多数字格式    | _(* #,##0.00_);...* "-"??_);_(@_)   | n  | 1,234.56 ||
| <br><br><br>**时间日期格式** | | | | |
| 时间        | hh:mm AM/PM | d                 |10:23 AM||
| 时间24H     | hh:mm | d                       |10:23||
| 日期时间    | yyyy-MM-dd hh:mm AM/PM   | d    |2020-07-29 10:23 AM||
| 日期时间24H | yyyy-MM-dd hh:mm   | d           |2020-07-29 10:23||
| 日期         | yyyy-MM-dd | d                 | 1930-08-05 ||
| 日期         | yyyy/MM/dd | d                 | 1930/8/5 ||
| 日期         | yyyy"年"M"月"d"日" | d                 | 1930年8月5日 ||
| 日期         | MM-dd | d                      | 08-05 ||
| 日期         | M-d | d                        | 8-5 ||
| 日期         | M"月"d"日" | d                 | 8月5日 ||
| 日期         | h:mm:ss | d                    | 13:30:30 ||
| 日期         | h:mm | d                       | 13:30 ||
| 日期         | AM/PM hh:mm | d                | 下午01:30 ||
| 日期         | AM/PM h:mm | d                 | 下午1:30 ||
| 日期         | AM/PM h:mm:ss | d              | 下午1:30:30 ||
| 日期         | MM-dd AM/PM hh:mm | d          | 下08-05 下午01:30 ||
| <br><br><br>**货币格式** | | | | |
| 货币:人民币        | "¥" 0.00 | n           | ¥ 123.00 |也支持 ¥ #.00 或者 ¥0.00|
| 货币:美元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:欧元        | "€" 0.00 | n           | € 123.00 ||     
| 货币:英镑        | "￡" 0.00 | n           | ￡ 123.00 ||     
| 货币:港元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:日元        | "￥" 0.00 | n           | ￥ 123.00 ||     
| 货币:阿尔巴尼亚列克        | "Lek" 0.00 | n           | Lek 123.00 ||     
| 货币:阿尔及利亚第纳尔        | "din" 0.00 | n           | din 123.00 ||     
| 货币:阿富汗尼        | "Af" 0.00 | n           | Af 123.00 ||     
| 货币:阿根廷比索        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:阿拉伯联合酋长国迪拉姆        | "dh" 0.00 | n           | dh 123.00 ||     
| 货币:阿鲁巴弗罗林        | "Afl" 0.00 | n           | Afl 123.00 ||     
| 货币:阿曼里亚尔        | "Rial" 0.00 | n           | Rial 123.00 ||     
| 货币:阿塞拜疆马纳特        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:埃及镑        | "￡" 0.00 | n           | ￡ 123.00 ||     
| 货币:埃塞俄比亚比尔        | "Birr" 0.00 | n           | Birr 123.00 ||     
| 货币:安哥拉宽扎        | "Kz" 0.00 | n           | Kz 123.00 ||     
| 货币:澳大利亚元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:澳门元        | "MOP" 0.00 | n           | MOP 123.00 ||     
| 货币:巴巴多斯元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:巴布亚新几内亚基那        | "PGK" 0.00 | n           | PGK 123.00 ||     
| 货币:巴哈马元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:巴基斯坦卢比        | "Rs" 0.00 | n           | Rs 123.00 ||     
| 货币:巴拉圭瓜拉尼        | "Gs" 0.00 | n           | Gs 123.00 ||     
| 货币:巴林第纳尔        | "din" 0.00 | n           | din 123.00 ||     
| 货币:巴拿马巴波亚        | "B/" 0.00 | n           | B/ 123.00 ||     
| 货币:巴西里亚伊        | "R$" 0.00 | n           | R$ 123.00 ||     
| 货币:白俄罗斯卢布        | "р" 0.00 | n           | р 123.00 ||     
| 货币:百慕大元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:保加利亚列弗        | "lev" 0.00 | n           | lev 123.00 ||    
| 货币:冰岛克朗        | "kr" 0.00 | n           | kr 123.00 ||     
| 货币:波黑可兑换马克        | "KM" 0.00 | n           | KM 123.00 ||     
| 货币:波兰兹罗提        | "z?" 0.00 | n           | z? 123.00 ||     
| 货币:玻利维亚诺        | "Bs" 0.00 | n           | Bs 123.00 ||     
| 货币:伯利兹元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:博茨瓦纳普拉        | "P" 0.00 | n           | P 123.00 ||     
| 货币:不丹努扎姆        | "Nu" 0.00 | n           | Nu 123.00 ||     
| 货币:布隆迪法郎        | "FBu" 0.00 | n           | FBu 123.00 ||     
| 货币:朝鲜圆        | "?KP" 0.00 | n           | ?KP 123.00 ||     
| 货币:丹麦克朗        | "kr" 0.00 | n           | kr 123.00 ||     
| 货币:东加勒比元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:多米尼加比索        | "RD$" 0.00 | n           | RD$ 123.00 ||     
| 货币:俄国卢布        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:厄立特里亚纳克法        | "Nfk" 0.00 | n           | Nfk 123.00 ||     
| 货币:非洲金融共同体法郎        | "CFA" 0.00 | n           | CFA 123.00 ||     
| 货币:菲律宾比索        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:斐济元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:佛得角埃斯库多        | "CVE" 0.00 | n           | CVE 123.00 ||     
| 货币:福克兰群岛镑        | "￡" 0.00 | n           | ￡ 123.00 ||     
| 货币:冈比亚达拉西        | "GMD" 0.00 | n           | GMD 123.00 ||     
| 货币:刚果法郎        | "FrCD" 0.00 | n           | FrCD 123.00 ||     
| 货币:哥伦比亚比索        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:哥斯达黎加科朗        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:古巴比索        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:古巴可兑换比索        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:圭亚那元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:哈萨克斯坦坚戈        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:海地古德        | "HTG" 0.00 | n           | HTG 123.00 ||     
| 货币:韩元        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:荷属安的列斯盾        | "NAf." 0.00 | n           | NAf. 123.00 ||     
| 货币:洪都拉斯拉伦皮拉        | "L" 0.00 | n           | L 123.00 ||     
| 货币:吉布提法郎        | "Fdj" 0.00 | n           | Fdj 123.00 ||     
| 货币:吉尔吉斯斯坦索姆        | "KGS" 0.00 | n           | KGS 123.00 ||     
| 货币:几内亚法郎        | "FG" 0.00 | n           | FG 123.00 ||     
| 货币:加拿大元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:加纳塞地        | "GHS" 0.00 | n           | GHS 123.00 ||     
| 货币:柬埔寨瑞尔        | "Riel" 0.00 | n           | Riel 123.00 ||     
| 货币:捷克克朗        | "K?" 0.00 | n           | K? 123.00 ||     
| 货币:津巴布韦元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:卡塔尔里亚尔        | "Rial" 0.00 | n           | Rial 123.00 ||     
| 货币:开曼群岛元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:科摩罗法郎        | "CF" 0.00 | n           | CF 123.00 ||     
| 货币:科威特第纳尔        | "din" 0.00 | n           | din 123.00 ||     
| 货币:克罗地亚库纳        | "kn" 0.00 | n           | kn 123.00 ||     
| 货币:肯尼亚先令        | "Ksh" 0.00 | n           | Ksh 123.00 ||     
| 货币:莱索托洛蒂        | "LSL" 0.00 | n           | LSL 123.00 ||     
| 货币:老挝基普        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:黎巴嫩镑        | "L￡" 0.00 | n           | L￡ 123.00 ||     
| 货币:立陶宛立特        | "Lt" 0.00 | n           | Lt 123.00 ||     
| 货币:利比亚第纳尔        | "din" 0.00 | n           | din 123.00 ||     
| 货币:利比亚元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:卢旺达法郎        | "RF" 0.00 | n           | RF 123.00 ||     
| 货币:罗马尼亚列伊        | "RON" 0.00 | n           | RON 123.00 ||     
| 货币:马达加斯加阿里亚里        | "Ar" 0.00 | n           | Ar 123.00 ||     
| 货币:马尔代夫拉菲亚        | "Rf" 0.00 | n           | Rf 123.00 ||     
| 货币:马拉维克瓦查        | "MWK" 0.00 | n           | MWK 123.00 ||     
| 货币:马来西亚林吉特        | "RM" 0.00 | n           | RM 123.00 ||     
| 货币:马其顿戴第纳尔        | "din" 0.00 | n           | din 123.00 ||     
| 货币:毛里求斯卢比        | "MURs" 0.00 | n           | MURs 123.00 ||     
| 货币:毛里塔尼亚乌吉亚        | "MRO" 0.00 | n           | MRO 123.00 ||     
| 货币:蒙古图格里克        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:孟加拉塔卡        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:秘鲁新索尔        | "S/" 0.00 | n           | S/ 123.00 ||     
| 货币:缅甸开亚特        | "K" 0.00 | n           | K 123.00 ||     
| 货币:摩尔多瓦列伊        | "MDL" 0.00 | n           | MDL 123.00 ||     
| 货币:摩洛哥迪拉姆        | "dh" 0.00 | n           | dh 123.00 ||     
| 货币:莫桑比克梅蒂卡尔        | "MTn" 0.00 | n           | MTn 123.00 ||     
| 货币:墨西哥比索        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:纳米比亚元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:南非兰特        | "R" 0.00 | n           | R 123.00 ||     
| 货币:南苏丹镑        | "￡" 0.00 | n           | ￡ 123.00 ||     
| 货币:尼加拉瓜科多巴        | "C$" 0.00 | n           | C$ 123.00 ||     
| 货币:尼泊尔卢比        | "Rs" 0.00 | n           | Rs 123.00 ||     
| 货币:尼日利亚奈拉        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:挪威克朗        | "kr" 0.00 | n           | kr 123.00 ||     
| 货币:乔治亚拉瑞        | "GEL" 0.00 | n           | GEL 123.00 ||     
| 货币:人民币（离岸）        | "￥" 0.00 | n           | ￥ 123.00 ||     
| 货币:瑞典克朗        | "kr" 0.00 | n           | kr 123.00 ||     
| 货币:瑞士法郎        | "CHF" 0.00 | n           | CHF 123.00 ||     
| 货币:塞尔维亚第纳尔        | "din" 0.00 | n           | din 123.00 ||     
| 货币:塞拉利昂利昂        | "SLL" 0.00 | n           | SLL 123.00 ||     
| 货币:塞舌尔卢比        | "SCR" 0.00 | n           | SCR 123.00 ||     
| 货币:沙特里亚尔        | "Rial" 0.00 | n           | Rial 123.00 ||     
| 货币:圣多美多布拉        | "Db" 0.00 | n           | Db 123.00 ||     
| 货币:圣赫勒拿群岛磅        | "￡" 0.00 | n           | ￡ 123.00 ||     
| 货币:斯里兰卡卢比        | "Rs" 0.00 | n           | Rs 123.00 ||     
| 货币:斯威士兰里兰吉尼        | "SZL" 0.00 | n           | SZL 123.00 ||     
| 货币:苏丹镑        | "SDG" 0.00 | n           | SDG 123.00 ||     
| 货币:苏里南元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:所罗门群岛元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:索马里先令        | "SOS" 0.00 | n           | SOS 123.00 ||     
| 货币:塔吉克斯坦索莫尼        | "Som" 0.00 | n           | Som 123.00 ||     
| 货币:太平洋法郎        | "FCFP" 0.00 | n           | FCFP 123.00 ||     
| 货币:泰国铢        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:坦桑尼亚先令        | "TSh" 0.00 | n           | TSh 123.00 ||     
| 货币:汤加潘加        | "T$" 0.00 | n           | T$ 123.00 ||     
| 货币:特立尼达和多巴哥元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:突尼斯第纳尔        | "din" 0.00 | n           | din 123.00 ||     
| 货币:土耳其里拉        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:瓦努阿图瓦图        | "VUV" 0.00 | n           | VUV 123.00 ||     
| 货币:危地马拉格查尔        | "Q" 0.00 | n           | Q 123.00 ||     
| 货币:委内瑞拉博利瓦        | "Bs" 0.00 | n           | Bs 123.00 ||     
| 货币:文莱元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:乌干达先令        | "UGX" 0.00 | n           | UGX 123.00 ||     
| 货币:乌克兰格里夫尼亚        | "грн." 0.00 | n           | грн. 123.00 ||     
| 货币:乌拉圭比索        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:乌兹别克斯坦苏姆        | "so?m" 0.00 | n           | so?m 123.00 ||     
| 货币:西萨摩亚塔拉        | "WST" 0.00 | n           | WST 123.00 ||     
| 货币:新加坡元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:新台币        | "NT$" 0.00 | n           | NT$ 123.00 ||     
| 货币:新西兰元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:匈牙利福林        | "Ft" 0.00 | n           | Ft 123.00 ||     
| 货币:叙利亚镑        | "￡" 0.00 | n           | ￡ 123.00 ||     
| 货币:牙买加元        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:亚美尼亚德拉姆        | "Dram" 0.00 | n           | Dram 123.00 ||     
| 货币:也门里亚尔        | "Rial" 0.00 | n           | Rial 123.00 ||     
| 货币:伊拉克第纳尔        | "din" 0.00 | n           | din 123.00 ||     
| 货币:伊朗里亚尔        | "Rial" 0.00 | n           | Rial 123.00 ||     
| 货币:以色列新谢克尔        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:印度卢比        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:印度尼西亚卢比        | "Rp" 0.00 | n           | Rp 123.00 ||     
| 货币:约旦第纳尔        | "din" 0.00 | n           | din 123.00 ||     
| 货币:越南盾        | "?" 0.00 | n           | ? 123.00 ||     
| 货币:赞比亚克瓦查        | "ZMW" 0.00 | n           | ZMW 123.00 ||     
| 货币:直布罗陀镑        | "￡" 0.00 | n           | ￡ 123.00 ||     
| 货币:智利比索        | "$" 0.00 | n           | $ 123.00 ||     
| 货币:中非金融合作法郎        | "FCFA" 0.00 | n           | FCFA 123.00 || 


注意: 导入/导出只用考虑用户看到的数据样式，例如excel中处理日期格式的方式为把日期统一转换为数字：42736 代表 2017-1-1