عکس AhmadMaleki
Useful Persian utilitiesJavaScript
موضوع‌ها
۰
فورک‌ها
۰
ستاره‌ها
۹
تاریخ ایجاد
۲۷ آبان ۱۳۹۹
آخرین بروزرسانی
۳ ماه قبل
لایسنس
ISC License

fa-utils

Useful Persian utilities

NPM Version Downloads Stats All Contributors

This is a combination of simple but useful persian-related functions (number modifiers for now).

Installation

npm:

npm install fa-utils

Usage

ES6:

import { toEnDigit, toFaDigit, toArDigit } from 'fa-utils'

ES5 / CommonJS:

var { toEnDigit, toFaDigit, toArDigit } = require('fa-utils')

Examples

All functions can take String or Number as argument and return a String.

  • toEnDigit()

    Convert Persian/Arabic numbers to English:

    toEnDigit("۱۲۳۴۵۶۷۸۹۰")    // returns: "1234567890"
    toEnDigit("١٢٣٤٥٦٧٨٩۰")    // returns: "1234567890"
    toEnDigit("fa۱۲۳۴ ar١٢٣٤") // returns: "fa1234 ar1234"
    toEnDigit("۱۲۳.۴۵")        // returns: "123.45"
    
  • toFaDigit()

    Convert English/Arabic numbers to Persian:

    toFaDigit(1234567890)      // returns: "۱۲۳۴۵۶۷۸۹۰"
    toFaDigit("1234567890")    // returns: "۱۲۳۴۵۶۷۸۹۰"
    toFaDigit("١٢٣٤٥٦٧٨٩۰")    // returns: "۱۲۳۴۵۶۷۸۹۰"
    toFaDigit("123.45")        // returns: "۱۲۳.۴۵"
    
  • toArDigit()

    Convert English/Persian numbers to Arabic:

    toArDigit(1234567890)      // returns: "١٢٣٤٥٦٧٨٩٠"
    toArDigit("1234567890")    // returns: "١٢٣٤٥٦٧٨٩٠"
    toArDigit("۱۲۳۴۵۶۷۸۹۰")    // returns: "١٢٣٤٥٦٧٨٩٠"
    toArDigit("123.45")        // returns: "١٢٣.٤٥"
    

Release History

  • 0.1.4
    • Enhance package.json
  • 0.1.3
    • Add TypeScript type declaration (Thanks to @geopic)
  • 0.1.2
    • Add autocomplete for methods
  • 0.1.1
    • Add Readme
  • 0.1.0
    • Initial Release

License

Distributed under the ISC license. See LICENSE for more information.

Contributing

All contributions are welcome and I appreciate them. Including adding new functionality or improve current ones. (Even fixing typos)

  1. Fork it (https://github.com/AhmadMaleki/fa-utils/fork)
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Commit your changes (git commit -am 'Add some fooBar')
  4. Push to the branch (git push origin feature/fooBar)
  5. Create a new Pull Request

Contributors ✨

Thanks goes to these wonderful people (emoji key):


George Pickering

💻

This project follows the all-contributors specification. Contributions of any kind welcome!