@smakss/convert-numbers
v2.1.0
Published
Convert Numbers transforms Arabic and Persian numerals to English, ensuring data uniformity in multilingual environments. Ideal for user input standardization and database consistency.
Downloads
281
Maintainers
Keywords
Readme
Convert Numbers
Convert Numbers is a utility package designed to ensure consistency in data transfer by converting Arabic and Persian numerals to English numerals. This tool is essential when user inputs might originate from different keyboard settings, requiring standardization of all digits to English format before further processing or database storage.
Demo
Check out the working demo on CodeSandbox:
Installation
Install the package using npm or yarn:
npm i @smakss/convert-numbers
# or
yarn add @smakss/convert-numbers
Usage
Import convertNumbers
into your project as a CommonJS or ECMAScript module:
ECMAScript Modules:
import ConvertNumbers from '@smakss/convert-numbers';
Then, use the function like this:
// Converts Persian numbers to '1234567890'
console.log(ConvertNumbers('۱۲۳۴۵۶۷۸۹۰'));
// Converts Arabic numbers to '1234567890'
console.log(ConvertNumbers('١٢٣٤٥٦٧٨٩٠'));
// Returns an empty string for no input
console.log(ConvertNumbers());
Features
- Robust conversion: Utilizes a mapping approach for efficiency and readability, with a fallback to regular expressions for longer strings.
- Error resilience: In case of unforeseen errors or compatibility issues, the function gracefully falls back to a basic
for-of
loop iteration. - Wide compatibility: Designed to work across a variety of JavaScript environments.
Documentation
For more detailed examples and information about the function usage, refer to the JSDoc comments in the source code.
Contributing
We welcome contributions! For guidelines on how to contribute, please check CONTRIBUTING.md.
Code of Conduct
We are committed to fostering a welcoming and positive community. Please see our Code of Conduct for more information.