to-words
Version:
Convert numbers to words in 132 locales with currency, ordinal, and BigInt support (TypeScript, ESM/CJS/UMD).
282 lines (281 loc) • 10.9 kB
JavaScript
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.ToWords = void 0;
exports.toWords = toWords;
exports.toOrdinal = toOrdinal;
exports.toCurrency = toCurrency;
const ToWordsCore_js_1 = require("../ToWordsCore.js");
class Locale {
config = {
currency: {
name: '元',
plural: '元',
singular: '元',
symbol: 'NT$',
fractionalUnit: {
name: '分',
singular: '分',
plural: '分',
symbol: '',
},
},
texts: {
and: '',
minus: '負',
only: '整',
point: '點',
},
numberWordsMapping: [
{ number: 100000000000000000000n, value: '垓' },
{ number: 10000000000000000000n, value: '千京' },
{ number: 1000000000000000000n, value: '百京' },
{ number: 100000000000000000n, value: '十京' },
{ number: 10000000000000000n, value: '京' },
{ number: 1000000000000000, value: '千兆' },
{ number: 100000000000000, value: '百兆' },
{ number: 10000000000000, value: '十兆' },
{ number: 1000000000000, value: '兆' },
{ number: 100000000000, value: '千億' },
{ number: 10000000000, value: '百億' },
{ number: 1000000000, value: '十億' },
{ number: 100000000, value: '億' },
{ number: 10000000, value: '千萬' },
{ number: 1000000, value: '百萬' },
{ number: 100000, value: '十萬' },
{ number: 10000, value: '萬' },
{ number: 1000, value: '千' },
{ number: 100, value: '百' },
{ number: 90, value: '九十' },
{ number: 80, value: '八十' },
{ number: 70, value: '七十' },
{ number: 60, value: '六十' },
{ number: 50, value: '五十' },
{ number: 40, value: '四十' },
{ number: 30, value: '三十' },
{ number: 20, value: '二十' },
{ number: 10, value: '十' },
{ number: 9, value: '九' },
{ number: 8, value: '八' },
{ number: 7, value: '七' },
{ number: 6, value: '六' },
{ number: 5, value: '五' },
{ number: 4, value: '四' },
{ number: 3, value: '三' },
{ number: 2, value: '二' },
{ number: 1, value: '一' },
{ number: 0, value: '零' },
],
ignoreOneForWords: [
'十',
'百',
'千',
'萬',
'十萬',
'百萬',
'千萬',
'億',
'十億',
'百億',
'千億',
'兆',
'十兆',
'百兆',
'千兆',
],
ordinalWordsMapping: [
{ number: 100, value: '第百' },
{ number: 90, value: '第九十' },
{ number: 80, value: '第八十' },
{ number: 70, value: '第七十' },
{ number: 60, value: '第六十' },
{ number: 50, value: '第五十' },
{ number: 40, value: '第四十' },
{ number: 30, value: '第三十' },
{ number: 20, value: '第二十' },
{ number: 10, value: '第十' },
{ number: 9, value: '第九' },
{ number: 8, value: '第八' },
{ number: 7, value: '第七' },
{ number: 6, value: '第六' },
{ number: 5, value: '第五' },
{ number: 4, value: '第四' },
{ number: 3, value: '第三' },
{ number: 2, value: '第二' },
{ number: 1, value: '第一' },
{ number: 0, value: '第零' },
],
ordinalExactWordsMapping: [
{ number: 1, value: '第一' },
{ number: 2, value: '第二' },
{ number: 3, value: '第三' },
{ number: 4, value: '第四' },
{ number: 5, value: '第五' },
{ number: 6, value: '第六' },
{ number: 7, value: '第七' },
{ number: 8, value: '第八' },
{ number: 9, value: '第九' },
{ number: 10, value: '第十' },
{ number: 20, value: '第二十' },
{ number: 30, value: '第三十' },
{ number: 40, value: '第四十' },
{ number: 50, value: '第五十' },
{ number: 60, value: '第六十' },
{ number: 70, value: '第七十' },
{ number: 80, value: '第八十' },
{ number: 90, value: '第九十' },
{ number: 100, value: '第百' },
],
formalConfig: {
numberWordsMapping: [
{ number: 100000000000000000000n, value: '垓' },
{ number: 10000000000000000000n, value: '仟京' },
{ number: 1000000000000000000n, value: '佰京' },
{ number: 100000000000000000n, value: '拾京' },
{ number: 10000000000000000n, value: '京' },
{ number: 1000000000000000, value: '仟兆' },
{ number: 100000000000000, value: '佰兆' },
{ number: 10000000000000, value: '拾兆' },
{ number: 1000000000000, value: '兆' },
{ number: 100000000000, value: '仟億' },
{ number: 10000000000, value: '佰億' },
{ number: 1000000000, value: '拾億' },
{ number: 100000000, value: '億' },
{ number: 10000000, value: '仟萬' },
{ number: 1000000, value: '佰萬' },
{ number: 100000, value: '拾萬' },
{ number: 10000, value: '萬' },
{ number: 1000, value: '仟' },
{ number: 100, value: '佰' },
{ number: 90, value: '玖拾' },
{ number: 80, value: '捌拾' },
{ number: 70, value: '柒拾' },
{ number: 60, value: '陸拾' },
{ number: 50, value: '伍拾' },
{ number: 40, value: '肆拾' },
{ number: 30, value: '參拾' },
{ number: 20, value: '貳拾' },
{ number: 10, value: '拾' },
{ number: 9, value: '玖' },
{ number: 8, value: '捌' },
{ number: 7, value: '柒' },
{ number: 6, value: '陸' },
{ number: 5, value: '伍' },
{ number: 4, value: '肆' },
{ number: 3, value: '參' },
{ number: 2, value: '貳' },
{ number: 1, value: '壹' },
{ number: 0, value: '零' },
],
ignoreOneForWords: [
'拾',
'佰',
'仟',
'萬',
'拾萬',
'佰萬',
'仟萬',
'億',
'拾億',
'佰億',
'仟億',
'兆',
'拾兆',
'佰兆',
'仟兆',
],
currency: {
name: '圓',
plural: '圓',
singular: '圓',
symbol: 'NT$',
fractionalUnit: {
name: '分',
singular: '分',
plural: '分',
symbol: '',
},
},
ordinalWordsMapping: [
{ number: 100, value: '第佰' },
{ number: 90, value: '第玖拾' },
{ number: 80, value: '第捌拾' },
{ number: 70, value: '第柒拾' },
{ number: 60, value: '第陸拾' },
{ number: 50, value: '第伍拾' },
{ number: 40, value: '第肆拾' },
{ number: 30, value: '第參拾' },
{ number: 20, value: '第貳拾' },
{ number: 10, value: '第拾' },
{ number: 9, value: '第玖' },
{ number: 8, value: '第捌' },
{ number: 7, value: '第柒' },
{ number: 6, value: '第陸' },
{ number: 5, value: '第伍' },
{ number: 4, value: '第肆' },
{ number: 3, value: '第參' },
{ number: 2, value: '第貳' },
{ number: 1, value: '第壹' },
{ number: 0, value: '第零' },
],
ordinalExactWordsMapping: [
{ number: 1, value: '第壹' },
{ number: 2, value: '第貳' },
{ number: 3, value: '第參' },
{ number: 4, value: '第肆' },
{ number: 5, value: '第伍' },
{ number: 6, value: '第陸' },
{ number: 7, value: '第柒' },
{ number: 8, value: '第捌' },
{ number: 9, value: '第玖' },
{ number: 10, value: '第拾' },
{ number: 20, value: '第貳拾' },
{ number: 30, value: '第參拾' },
{ number: 40, value: '第肆拾' },
{ number: 50, value: '第伍拾' },
{ number: 60, value: '第陸拾' },
{ number: 70, value: '第柒拾' },
{ number: 80, value: '第捌拾' },
{ number: 90, value: '第玖拾' },
{ number: 100, value: '第佰' },
],
},
};
}
exports.default = Locale;
/**
* ToWords class pre-configured for this locale.
* This is a lightweight version that only bundles this specific locale.
*
* @example
* import { ToWords } from 'to-words/zh-TW';
* const tw = new ToWords();
* tw.convert(1234);
*/
class ToWords extends ToWordsCore_js_1.ToWordsCore {
constructor(options = {}) {
super(options);
this.setLocale(Locale);
}
}
exports.ToWords = ToWords;
// Module-level singleton — reused across calls to avoid per-call instance creation
const instance = new ToWords();
/**
* Convert a number to words for this locale (functional style).
*/
function toWords(number, options) {
return instance.convert(number, options);
}
/**
* Convert a number to ordinal words for this locale (functional style).
*/
function toOrdinal(number, options) {
return instance.toOrdinal(number, options);
}
/**
* Convert a number to currency words for this locale (functional style).
* Shorthand for toWords(number, { currency: true, ...options }).
*/
function toCurrency(number, options) {
return instance.convert(number, { ...options, currency: true });
}