Harfizer は、数字、日付、時刻をテキストに変換するための強力なパッケージです。言語固有のプラグインを利用することで、数値や時間を対応する文章表現に簡単に変換できます。
もし他の言語をご希望の場合は、上記または下部にある各言語のドキュメントリンクをご確認ください。
npm を使用して Harfizer をインストールしてください:
npm install harfizerパッケージからプラグインと CoreConverter クラスをインポートします:
import { CoreConverter, JapaneseLanguagePlugin } from 'harfizer';
const japanesePlugin = new JapaneseLanguagePlugin();
const converter = new CoreConverter(japanesePlugin);指定された数字（整数または小数、負の数も含む）を日本語のテキスト表現に変換します。小数部分は「点」を使って一桁ずつ読み上げられます。
パラメーター:
- input: 数字、数字文字列、または bigint。
- options (オプション): 変換をカスタマイズするためのオブジェクト:
customZeroWord– デフォルトの「零」を上書きします。customNegativeWord– デフォルトの「マイナス」を上書きします。customSeparator– トークン間のデフォルトの区切り文字を上書きします。
返り値:
数字の日本語テキスト表現の文字列。
例:
converter.convertNumber("123");
// 出力: "百二十三"
converter.convertNumber("-456.78");
// 出力: "マイナス 四百五十六 点 七八"4桁以下の数字を日本語のテキスト表現に変換します（10,000未満の数値を処理するために使用）。
パラメーター:
- num: 最大4桁の数値。
返り値:
その数字の日本語テキスト表現の文字列（例："四百五十六"）。
例:
converter.convertTripleToWords(789);
// 出力: "七百八十九"公暦の日付文字列（"YYYY/MM/DD" または "YYYY-MM-DD" 形式）を日本語のテキスト表現に変換します。出力形式は「YYYY年MM月DD日」で、各部分は日本語の数字に変換されます。
パラメーター:
- dateStr: 日付文字列。
- calendar (オプション): 日本語では公暦のみサポートされます（デフォルトは "gregorian"）。
返り値:
日付の日本語テキスト表現の文字列。
例:
converter.convertDateToWords("2023/04/05");
// 出力: "二零二三年四月五日"時間文字列（"HH:mm" 形式）を日本語のテキスト表現に変換します。出力形式は「時分」です。分が 0 の場合は「時」のみが返されます。
パラメーター:
- timeStr: "HH:mm" 形式の時間文字列。
返り値:
時間の日本語テキスト表現の文字列。
例:
converter.convertTimeToWords("09:00");
// 出力: "九時"
converter.convertTimeToWords("09:05");
// 出力: "九時五分"以下は JapaneseLanguagePlugin と CoreConverter を使用した例です:
import { CoreConverter, JapaneseLanguagePlugin } from 'harfizer';
const japanesePlugin = new JapaneseLanguagePlugin();
const converter = new CoreConverter(japanesePlugin);
console.log(converter.convertNumber("123"));
// 出力: "百二十三"
console.log(converter.convertDateToWords("2023/04/05"));
// 出力: "二零二三年四月五日"
console.log(converter.convertTimeToWords("09:05"));
// 出力: "九時五分"convertNumber メソッドは、変換をカスタマイズするためにオプションの ConversionOptions オブジェクトを受け取ります:
const options = {
customZeroWord: "零",
customNegativeWord: "マイナス",
customSeparator: " "
};
console.log(converter.convertNumber("-123", options));
// 出力: "マイナス 百二十三"他の言語プラグインのドキュメントについては、以下のファイルを参照してください:
- 🇬🇧 英語プラグインのドキュメント
- 🇮🇷 波斯語プラグインのドキュメント
- 🇫🇷 フランス語プラグインのドキュメント
- 🇯🇵 日本語プラグインのドキュメント
- 🇨🇳 中国語プラグインのドキュメント
- 🇷🇺 ロシア語プラグインのドキュメント
- 🇩🇪 ドイツ語プラグインのドキュメント
- 🇪🇸 スペイン語プラグインのドキュメント
このパッケージは MIT ライセンスの下で公開されています。