ant-design/components/statistic/index.zh-CN.md

---
category: Components
subtitle: 统计数值
type: 数据展示
title: Statistic
cover: https://gw.alipayobjects.com/zos/antfincdn/rcBNhLBrKbE/Statistic.svg
---

展示统计数值。

## 何时使用

- 当需要突出某个或某组数字时。
- 当需要展示带描述的统计类数据时使用。

## API

#### Statistic

| 参数             | 说明             | 类型                 | 默认值 | 版本 |
| ---------------- | ---------------- | -------------------- | ------ | ---- |
| decimalSeparator | 设置小数点       | string               | `.`    |      |
| formatter        | 自定义数值展示   | (value) => ReactNode | -      |      |
| groupSeparator   | 设置千分位标识符 | string               | `,`    |      |
| precision        | 数值精度         | number               | -      |      |
| prefix           | 设置数值的前缀   | ReactNode            | -      |      |
| suffix           | 设置数值的后缀   | ReactNode            | -      |      |
| title            | 数值的标题       | ReactNode            | -      |      |
| value            | 数值内容         | string \| number     | -      |      |
| valueStyle       | 设置数值的样式   | CSSProperties        | -      |      |

#### Statistic.Countdown

| 参数 | 说明 | 类型 | 默认值 | 版本 |
| --- | --- | --- | --- | --- |
| format | 格式化倒计时展示，参考 [moment](http://momentjs.com/) | string | `HH:mm:ss` |  |
| onFinish | 倒计时完成时触发 | () => void | - |  |
| prefix | 设置数值的前缀 | ReactNode | - |  |
| suffix | 设置数值的后缀 | ReactNode | - |  |
| title | 数值的标题 | ReactNode | - |  |
| value | 数值内容 | number \| moment | - |  |
| valueStyle | 设置数值的样式 | CSSProperties | - |  |
New component Statistic / Countdown (#14154) * init * number format * add Countdown * :zap: Try something ts stuff * move out Countdown * add format * support countdown * add prefix & suffix * Move Number to Statistic * adjust ts * clean up * roll back of lodash * update doc & style * variable of the less style * add demo test * full coverage * hide title if not need * update snapshot * update accessiblity * update color * stop countdown when time is out * formatTimeStr adjust * use reset class * add miss tab index * update doc * update title prop & snapshot * rm additional aria. It's over design * use card sample on unit demo * sfc * adjust demo 2019-01-09 20:38:09 +08:00			`---`
			`category: Components`
			`subtitle: 统计数值`
			`type: 数据展示`
			`title: Statistic`
docs: 🌈 Add Components overview page (#24491) * docs: Add components overview page * fix detail * remove ContributorsList form overview page * fix components url * improve code style * remove extra file * fix detail * fix lint * fix lint * docs: Finish components overview page * fix lint * docs: Update cover * fix lint * update cover * update menu * improve overview page * refactor code * fix order * update title * add components count * fix overview page ssr bug * move less file * update title margin Co-authored-by: arvinxx <arvinx@foxmail.com> 2020-05-31 11:48:34 +08:00			`cover: https://gw.alipayobjects.com/zos/antfincdn/rcBNhLBrKbE/Statistic.svg`
New component Statistic / Countdown (#14154) * init * number format * add Countdown * :zap: Try something ts stuff * move out Countdown * add format * support countdown * add prefix & suffix * Move Number to Statistic * adjust ts * clean up * roll back of lodash * update doc & style * variable of the less style * add demo test * full coverage * hide title if not need * update snapshot * update accessiblity * update color * stop countdown when time is out * formatTimeStr adjust * use reset class * add miss tab index * update doc * update title prop & snapshot * rm additional aria. It's over design * use card sample on unit demo * sfc * adjust demo 2019-01-09 20:38:09 +08:00			`---`

			`展示统计数值。`

			`## 何时使用`

:lipstick: prittier all files 2019-05-07 14:57:32 +08:00			`- 当需要突出某个或某组数字时。`
			`- 当需要展示带描述的统计类数据时使用。`
New component Statistic / Countdown (#14154) * init * number format * add Countdown * :zap: Try something ts stuff * move out Countdown * add format * support countdown * add prefix & suffix * Move Number to Statistic * adjust ts * clean up * roll back of lodash * update doc & style * variable of the less style * add demo test * full coverage * hide title if not need * update snapshot * update accessiblity * update color * stop countdown when time is out * formatTimeStr adjust * use reset class * add miss tab index * update doc * update title prop & snapshot * rm additional aria. It's over design * use card sample on unit demo * sfc * adjust demo 2019-01-09 20:38:09 +08:00
			`## API`

			`#### Statistic`

docs(update): removed 3.x version description in 4.0-prepare (#19827) * docs(update): removed 3.x version description in 4.0-prepare ref #19815 * docs(update): update docs remove carousel/index.zh-CN.md empty version column * docs(update): update docs remove carousel/index.en-US.md empty version column 2019-11-20 20:31:43 +08:00			`\| 参数 \| 说明 \| 类型 \| 默认值 \| 版本 \|`
			`\| ---------------- \| ---------------- \| -------------------- \| ------ \| ---- \|`
docs: format api list/popover/statistic (#25368) 2020-07-02 09:52:28 +08:00			\| decimalSeparator \| 设置小数点 \| string \| `.` \| \|
docs(update): removed 3.x version description in 4.0-prepare (#19827) * docs(update): removed 3.x version description in 4.0-prepare ref #19815 * docs(update): update docs remove carousel/index.zh-CN.md empty version column * docs(update): update docs remove carousel/index.en-US.md empty version column 2019-11-20 20:31:43 +08:00			`\| formatter \| 自定义数值展示 \| (value) => ReactNode \| - \| \|`
docs: unite boolean in site (#25058) * docs: unite boolean in site * fix demo * fix boolean * add * add * add 2020-06-17 23:18:14 +08:00			\| groupSeparator \| 设置千分位标识符 \| string \| `,` \| \|
docs(update): removed 3.x version description in 4.0-prepare (#19827) * docs(update): removed 3.x version description in 4.0-prepare ref #19815 * docs(update): update docs remove carousel/index.zh-CN.md empty version column * docs(update): update docs remove carousel/index.en-US.md empty version column 2019-11-20 20:31:43 +08:00			`\| precision \| 数值精度 \| number \| - \| \|`
docs: improve api type docs (#27038) 2020-10-09 10:08:52 +08:00			`\| prefix \| 设置数值的前缀 \| ReactNode \| - \| \|`
			`\| suffix \| 设置数值的后缀 \| ReactNode \| - \| \|`
			`\| title \| 数值的标题 \| ReactNode \| - \| \|`
docs(update): removed 3.x version description in 4.0-prepare (#19827) * docs(update): removed 3.x version description in 4.0-prepare ref #19815 * docs(update): update docs remove carousel/index.zh-CN.md empty version column * docs(update): update docs remove carousel/index.en-US.md empty version column 2019-11-20 20:31:43 +08:00			`\| value \| 数值内容 \| string \\| number \| - \| \|`
docs: improve style type (#23700) 2020-04-28 14:09:54 +08:00			`\| valueStyle \| 设置数值的样式 \| CSSProperties \| - \| \|`
New component Statistic / Countdown (#14154) * init * number format * add Countdown * :zap: Try something ts stuff * move out Countdown * add format * support countdown * add prefix & suffix * Move Number to Statistic * adjust ts * clean up * roll back of lodash * update doc & style * variable of the less style * add demo test * full coverage * hide title if not need * update snapshot * update accessiblity * update color * stop countdown when time is out * formatTimeStr adjust * use reset class * add miss tab index * update doc * update title prop & snapshot * rm additional aria. It's over design * use card sample on unit demo * sfc * adjust demo 2019-01-09 20:38:09 +08:00
			`#### Statistic.Countdown`

docs: show version Number features were added (#17373) * docs: add api first appearance * docs: fix auto-complete doc * docs: replace Version Added with Version * docs: date picker common method * docs: date picker common method * docs: tree * docs: remove meaningless 3.0.0 2019-07-11 14:14:33 +08:00			`\| 参数 \| 说明 \| 类型 \| 默认值 \| 版本 \|`
			`\| --- \| --- \| --- \| --- \| --- \|`
docs: unite boolean in site (#25058) * docs: unite boolean in site * fix demo * fix boolean * add * add * add 2020-06-17 23:18:14 +08:00			\| format \| 格式化倒计时展示，参考 [moment](http://momentjs.com/) \| string \| `HH:mm:ss` \| \|
docs(update): removed 3.x version description in 4.0-prepare (#19827) * docs(update): removed 3.x version description in 4.0-prepare ref #19815 * docs(update): update docs remove carousel/index.zh-CN.md empty version column * docs(update): update docs remove carousel/index.en-US.md empty version column 2019-11-20 20:31:43 +08:00			`\| onFinish \| 倒计时完成时触发 \| () => void \| - \| \|`
docs: improve api type docs (#27038) 2020-10-09 10:08:52 +08:00			`\| prefix \| 设置数值的前缀 \| ReactNode \| - \| \|`
			`\| suffix \| 设置数值的后缀 \| ReactNode \| - \| \|`
			`\| title \| 数值的标题 \| ReactNode \| - \| \|`
docs(update): removed 3.x version description in 4.0-prepare (#19827) * docs(update): removed 3.x version description in 4.0-prepare ref #19815 * docs(update): update docs remove carousel/index.zh-CN.md empty version column * docs(update): update docs remove carousel/index.en-US.md empty version column 2019-11-20 20:31:43 +08:00			`\| value \| 数值内容 \| number \\| moment \| - \| \|`
docs: improve style type (#23700) 2020-04-28 14:09:54 +08:00			`\| valueStyle \| 设置数值的样式 \| CSSProperties \| - \| \|`