number-to-chinese-words

1.0.20 • Public • Published

NPM

number-to-chinese-words

Convert a number to chinese words. 由數字轉為中文數目

此項目的測試以萬進制為基準,即10⁸為億,10¹²為兆 https://zh.wikipedia.org/wiki/億

Install

npm install number-to-chinese-words

API

The API is inspired from http://github.com/marlun78/number-to-words This package allow user to use same api from number-to-words for Chinese support.

toOrdinal(number)

將整數加上前置的「第」字。 如果輸入的數字包含小數點,小數點後的數目將會被移除。

var converter = require('number-to-chinese-words');
converter.toOrdinal(21); // => “第21”

toWords(number)

將數目轉換成文字。

// 整數:
var converter = require('number-to-chinese-words');
converter.toWords(13); // => “十三”
 
// Decimal numbers:
converter.toWords(2.9); // => “二點九”
 
// Negative numbers:
converter.toWords(-3); // => "負三"
 
// Large numbers:
converter.toWords(9007199254740992); // => “九千零七兆一千九百九十二億五千四百七十四萬零九百九十二”

toWordsOrdinal(number)

將整數轉換成文字,再加上前置的「第」字。 如果輸入的數字包含小數點,小數點後的數目將會被移除。

import converter from "number-to-chinese-words";
converter.toWordsOrdinal(21); // => “第二十一”

大寫

var converter = require("number-to-chinese-words")
converter.default.labels = Object.assign({},converter.default.labels, {
  digits : ['','', '', '', '', '', '', '', '', ''],
  units: ['','', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '']
})
 
converter.toWords(199254740992); // => 壹仟玖佰玖拾貳億伍仟肆佰柒拾肆萬零玖佰玖拾貳

Direct load javascript from html

  <script src="//unpkg.com/number-to-chinese-words@^1.0/number-to-chinese-words.min.js"></script> 
  <script>
    var converter = window.index.NumberToChineseWords;
    console.log(converter.toWords(13)); // => 十三
    console.log(converter.toWords(2.9)); // => 二點九
    console.log(converter.toWords(-3)); // => 負三
    console.log(converter.toWords(9007199254740992)); // => 九千零七兆一千九百九十二億五千四百七十四萬零九百九十二
 
    converter.labels = Object.assign({},converter.labels, {
      digits : ['','', '', '', '', '', '', '', '', ''],
      units: ['','', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '']
    });
 
    console.log(converter.toWords(199254740992));// => 壹仟玖佰玖拾貳億伍仟肆佰柒拾肆萬零玖佰玖拾貳
  </script> 

Package Sidebar

Install

npm i number-to-chinese-words

Weekly Downloads

198

Version

1.0.20

License

MIT

Unpacked Size

22 kB

Total Files

11

Last publish

Collaborators

  • komino