Japanese numeral service and filters for AngularJS
This is a service for AngularJS that converts common Arabic numerals to Japanese numerals. This service can be used as is, or through the filters japaneseNumerals
and simpleJapaneseNumerals
.
The japaneseNumerals
filter will convert the Arabic numerals to Japanese numerals, including the power of ten kanji characters.
The simpleJapaneseNumerals
filter will convert the Arabic numerals to Japanese numerals, using the '〇' character and positions instead of the power of ten kanji characters.
Both filters can be adjusted with parameters as described in the 'Documentation' section.
- Install via npm or downloaded files:
- via npm:
npm install --save angular-japanese-numerals
- via downloaded files
- via npm:
- Add
angular-japanese-numerals
to your application's module dependencies. - Include dependencies and angular-japanese-numerals in your HTML.
- When using npm
<script src="node_modules/angular-japanese-numerals/dist/angular-japanese-numerals.min.js"></script>
- When using downloaded files
<script src="YOUR_PATH/angular-japanese-numerals.min.js"></script>
- Use the angular filters
japaneseNumerals
andsimpleJapaneseNumerals
, or use the angular servicejapaneseNumeralService
.
Object containing all Japanese numeral characters.
Converts a number or string of Arabic numerals to a string of Japanese numerals with power of ten characters.
-
@param {number | string}
value The value to convert to Japanese numerals. -
@param {bool=} formal
Optional toggle to use formal numbers. -
@param {bool=} buFraction
Optional toggle to use bu fractions instead of wari fractions. -
@return {string}
A string of Japanese numerals converted from the original value.
Converts a number or string of Arabic numerals to a string of Japanese numerals without the power of ten characters.
-
@param {number | string}
value The value to convert to Japanese numerals. -
@param {bool=} formal
Optional toggle to use formal numbers. -
@return {string}
A string of Japanese numerals converted from the original value.
Converts a number or string of Arabic numerals to a string of Japanese numerals with power of ten characters.
-
@param {number | string} input
The value to convert to Japanese numerals. -
@param {bool=} formal
Optional toggle to use formal numbers. -
@param {bool=} buFraction
Optional toggle to use bu fractions instead of wari fractions. -
@return {string}
A string of Japanese numerals converted from the original value.
Converts a number or string of Arabic numerals to a string of Japanese numerals without power of ten characters.
-
@param {number | string} input
The value to convert to Japanese numerals. -
@param {bool=} formal
Optional toggle to use formal numbers. -
@return {string}
A string of Japanese numerals converted from the original value.
HTML
<p>
{{ 11 | japaneseNumerals }} : 11 normal
</p>
<p>
{{ 17 | japaneseNumerals: true }} : 17 formal
</p>
<p>
{{ '151' | japaneseNumerals }} : '151' normal
</p>
<p>
{{ 10.51 | japaneseNumerals: false: true }} : 10.51 normal buFraction
</p>
Result:
<p>
十一 : 11 normal
</p>
<p>
拾七 : 17 formal
</p>
<p>
百五十一 : '151' normal
</p>
<p>
十・五分一厘 : 10.51 normal
</p>
Javascript:
angular.module('app', ['angular-japanese-numerals']);
angular.module('app')
.controller('appController', function ($scope, $filter) {
$scope.javascriptNormal = $filter('japaneseNumerals')(469);
$scope.javascriptFormal = $filter('japaneseNumerals')(469, true);
});
Result:
<p>
四百六十九 : $scope.javascriptNormal 469 normal
</p>
<p>
四百六拾九 : $scope.javascriptFormal 469 formal
</p>
MIT