---
type: Basic
order: 5
title: number-to-chinese
subtitle: 人民币大写
cols: 1
module: import { NumberToChineseModule } from '@ohayo/components/number-to-chinese';
---

常用在数值转化为人民币大写。

## API

### numberToChinese

转化方法，包括三个参数：

| 参数 | 说明 | 类型 | 默认值 |
|----|----|----|-----|
| `value` | 值 | `number | string` | - |
| `rmb` | 是否RMB格式 | `boolean` | `true` |
| `options` | 额外选项 | `NumberToChineseOptions` | - |

### NumberToChineseOptions

| 参数 | 说明 | 类型 | 默认值 |
|----|----|----|-----|
| `minusSymbol` | 指定负数符号 | `string` | `负` |
| `validThrow` | 当传递值无法数值时抛出异常 | `boolean` | `false` |

## Pipe管道

使用 `n2c` 便于直接在模板中渲染，例如：

```html
{{ 100.12 | n2c }}
// Output: 壹佰元壹角贰分
```

更多格式请参数示例。