en-arabicjs v1.1.0

En ArabicJS

En ArabicJS is a library to convert English date, time, numbers, etc. to arabic and vice-versa.

Installation

npm i en-arabicjs

Usage

import ArabicJs from 'en-arabicjs';

// OR

import { toArabicNumbers,  toArabicDate } from 'en-arabicjs'; // import only the functions you need

Section Links

toArabicNumbers - toEnglishNumbers - toArabicDate - toEnglishDate - toArabic - toEnglish - transDate - transNumbers - trans - decodeURL & fixURL - Chaining

Documentation

Convert English Numbers to Arabic

import ArabicJs from 'en-arabicjs';
ArabicJs("123456789").toArabicNumbers()->toString(); // return: "١٢٣٤٥٦٧٨٩"
ArabicJs(123456789).toArabicNumbers()->toString(); // return: "١٢٣٤٥٦٧٨٩"
// We use it in the pervious way if we want to chain the methods for example toArabicNumbers()->toArabicDate()

// OR
import { toArabicNumbers } from 'en-arabicjs';
toArabicNumbers("123456789"); // return: "١٢٣٤٥٦٧٨٩"
toArabicNumbers(123456789); // return: "١٢٣٤٥٦٧٨٩"

Convert Arabic Numbers to English

ArabicJs("١٢٣٤٥٦٧٨٩").toEnglishNumbers()->toString(); // return: "123456789"

// OR
toEnglishNumbers("١٢٣٤٥٦٧٨٩"); // return: "123456789"

Convert English Date to Arabic

ArabicJs("تم نشر هذا الخبر يوم -Sunday الموافق Jun, 25 am").toArabicDate()->toString(); // return: "تم نشر هذا الخبر يوم -الأحد الموافق يونيو, 25 ص"
// OR
toArabicDate("تم نشر هذا الخبر يوم -Sunday الموافق Jun, 25 am"); // return: "تم نشر هذا الخبر يوم -الأحد الموافق يونيو, 25 ص"

Convert Arabic Date to English

ArabicJs("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, 25 ص").toEnglishDate()->toString(); // return: "تم نشر هذا الخبر يوم -Sunday الموافق June, 25 am"
// OR
toEnglishDate("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, 25 ص"); // return: "تم نشر هذا الخبر يوم -Sunday الموافق June, 25 am"

You can also chose if the returned english date is shorten or not in the previous example the default is not shorten

ArabicJs("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, 25 ص").toEnglishDate(true)->toString(); // return: "تم نشر هذا الخبر يوم -Sun الموافق Jun, 25 am"
// OR
toEnglishDate("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, 25 ص", true); // return: "تم نشر هذا الخبر يوم -Sun الموافق Jun, 25 am"

Convert English Numbers and Date to Arabic

ArabicJs("تم نشر هذا الخبر يوم -Sunday الموافق Jun, 25 am").toArabic()->toString(); // return: "تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص"
// OR
toArabic("تم نشر هذا الخبر يوم -Sunday الموافق Jun, 25 am"); // return: "تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص"

Convert Arabic Numbers and Date to English

ArabicJs("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص").toEnglish()->toString(); // return: "تم نشر هذا الخبر يوم -Sunday الموافق June, 25 am"
// OR
toEnglish("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص"); // return: "تم نشر هذا الخبر يوم -Sunday الموافق June, 25 am"

And as before you can make the output shorten

ArabicJs("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص").toEnglish(true)->toString(); // return: "تم نشر هذا الخبر يوم -Sun الموافق Jun, 25 am"
// OR
toEnglish("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص", true); // return: "تم نشر هذا الخبر يوم -Sun الموافق Jun, 25 am"

Translate Date to specefied locale

Availabe locales 'ar', 'en' Default 'ar'

ArabicJs("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, 25 ص").transDate('en')->toString(); // return: "تم نشر هذا الخبر يوم -Sunday الموافق June, 25 am"
// OR
transDate("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, 25 ص", 'en'); // return: "تم نشر هذا الخبر يوم -Sunday الموافق June, 25 am"

You can also chose if the returned english date is shorten or not in the previous example the default is not shorten

ArabicJs("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, 25 ص").transDate('en', true)->toString(); // return: "تم نشر هذا الخبر يوم -Sun الموافق Jun, 25 am"
// OR
transDate("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, 25 ص", 'en', true); // return: "تم نشر هذا الخبر يوم -Sun الموافق Jun, 25 am"

Translate Numbers to specefied locale

Availabe locales 'ar', 'en' Default 'ar'

ArabicJs("١٢٣٤٥٦٧٨٩").transNumbers('en')->toString(); // return: "123456789"
ArabicJs("123456789").transNumbers('ar')->toString(); // return: "١٢٣٤٥٦٧٨٩"

// OR
transNumbers("١٢٣٤٥٦٧٨٩", 'en'); // return: "123456789"
transNumbers("123456789"); // return: "١٢٣٤٥٦٧٨٩"

Translate Date and Numbers to specefied locale

Availabe locales 'ar', 'en' Default 'ar'

ArabicJs("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص").trans('en')->toString(); // return: "تم نشر هذا الخبر يوم -Sunday الموافق June, 25 am"
ArabicJs("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص").trans('en', true)->toString(); // return: "تم نشر هذا الخبر يوم -Sun الموافق Jun, 25 am"
ArabicJs("تم نشر هذا الخبر يوم -Sunday الموافق June, 25 am").trans('ar')->toString(); // return: "تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص"
// OR
trans("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص", 'en'); // return: "تم نشر هذا الخبر يوم -Sunday الموافق June, 25 am"
trans("تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص", 'en', true); // return: "تم نشر هذا الخبر يوم -Sun الموافق Jun, 25 am"
trans("تم نشر هذا الخبر يوم -Sunday الموافق June, 25 am", 'ar'); // return: "تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص"

Fix or Decode the URLs contains Arabic chars

ArabicJs("https://ar.wikipedia.org/wiki/%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9_%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9").decodeURL()->toString(); // return: "https://ar.wikipedia.org/wiki/الصفحة_الرئيسية"
ArabicJs("https://ar.wikipedia.org/wiki/%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9_%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9").fixURL()->toString(); // return: "https://ar.wikipedia.org/wiki/الصفحة_الرئيسية"

// OR

decodeURL("https://ar.wikipedia.org/wiki/%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9_%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9"); // return: "https://ar.wikipedia.org/wiki/الصفحة_الرئيسية"
fixURL("https://ar.wikipedia.org/wiki/%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9_%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9"); // return: "https://ar.wikipedia.org/wiki/الصفحة_الرئيسية"

Chaining usage

// Chaing in only available when using the default import
import ArabicJs from 'en-arabicjs';

ArabicJs("تم نشر هذا الخبر يوم -Sunday الموافق Jun, 25 am").toArabicNumbers().toArabicDate().toString(); // return: "تم نشر هذا الخبر يوم -الأحد الموافق يونيو, ٢٥ ص"

License

MIT