Package Exports

urdu-number-words

Readme

urdu-number-words

اردو نمبر الفاظ

Convert numbers to Urdu words with Pakistani currency (PKR) support.

Uses the South Asian numbering system — لاکھ، کروڑ، ارب

Installation · Usage · API · Examples · Contributing

Why This Package?

Pakistan's financial, legal, and business systems require numbers written in Urdu words — from cheque printing to government documents to invoices. Urdu has unique words for every number from 1 to 100 (unlike English where you can combine "twenty" + "one"), and uses the South Asian numbering system (لاکھ، کروڑ، ارب) instead of millions and billions.

No npm package existed that handled this correctly — until now.

Perfect for:

🏦 Cheque printing systems
🧾 Invoices and receipts in Urdu
📄 Legal and government documents
🛒 E-commerce platforms serving Pakistani users
💰 Any financial application needing Urdu amount formatting

Features

✅ Numbers to Urdu words (0 to کھربوں and beyond)
✅ South Asian numbering system (ہزار، لاکھ، کروڑ، ارب، کھرب)
✅ Pakistani Rupee (PKR) currency mode with optional "صرف" suffix
✅ Western to Urdu digit conversion (123 → ۱۲۳)
✅ Ordinal numbers (پہلا، دوسرا، تیسرا)
✅ Negative and decimal number support
✅ TypeScript-first with full type definitions
✅ Zero dependencies
✅ Works in Node.js, browsers, Deno, and Bun

Installation

npm install urdu-number-words

yarn add urdu-number-words

pnpm add urdu-number-words

Usage

Basic Conversion

import { toUrduWords } from 'urdu-number-words';

toUrduWords(0);          // "صفر"
toUrduWords(25);         // "پچیس"
toUrduWords(100);        // "ایک سو"
toUrduWords(1500);       // "ایک ہزار پانچ سو"
toUrduWords(100000);     // "ایک لاکھ"
toUrduWords(4325718);    // "تینتالیس لاکھ پچیس ہزار سات سو اٹھارہ"
toUrduWords(10000000);   // "ایک کروڑ"
toUrduWords(1000000000); // "ایک ارب"
toUrduWords(-42);        // "منفی بیالیس"

Currency Mode (PKR)

import { toUrduWords } from 'urdu-number-words';

toUrduWords(5000, { currency: true });
// "پانچ ہزار روپے"

toUrduWords(1500.75, { currency: true });
// "ایک ہزار پانچ سو روپے اور پچھتر پیسے"

toUrduWords(250000, { currency: true });
// "ڈھائی لاکھ روپے"

// Append "صرف" when appendOnly is true
toUrduWords(5000, { currency: true, appendOnly: true });
// "پانچ ہزار روپے صرف"

Urdu Digits

import { toUrduDigits } from 'urdu-number-words';

toUrduDigits(12345);    // "۱۲۳۴۵"
toUrduDigits(1500.75);  // "۱۵۰۰.۷۵"
toUrduDigits("03001234567"); // "۰۳۰۰۱۲۳۴۵۶۷"

Ordinal Numbers

import { toUrduOrdinal } from 'urdu-number-words';

toUrduOrdinal(1);  // "پہلا"
toUrduOrdinal(2);  // "دوسرا"
toUrduOrdinal(3);  // "تیسرا"
toUrduOrdinal(4);  // "چوتھا"

CommonJS

const { toUrduWords, toUrduDigits, toUrduOrdinal } = require('urdu-number-words');

toUrduWords(786); // "سات سو چھیاسی"

Browser (CDN)

<script src="https://cdn.jsdelivr.net/npm/urdu-number-words/dist/index.min.js"></script>
<script>
  console.log(UrduNumberWords.toUrduWords(786));
  // "سات سو چھیاسی"
</script>

API

`toUrduWords(num, options?)`

Converts a number to Urdu words.

Parameter	Type	Description
`num`	`number \| string`	The number to convert. Use string for very large numbers.
`options`	`object`	Optional configuration (see below).

Options:

Option	Type	Default	Description
`currency`	`boolean`	`false`	Enable PKR currency mode.
`currencyName`	`string`	`"روپے"`	Currency unit name.
`fractionalName`	`string`	`"پیسے"`	Fractional unit name.
`appendOnly`	`boolean`	`false`	Append "صرف" at the end in currency mode.

Returns: string — The Urdu words representation.

`toUrduDigits(num)`

Converts Western digits (0-9) to Urdu digits (۰-۹).

Parameter	Type	Description
`num`	`number \| string`	The number to convert.

Returns: string — The number with Urdu digits.

`toUrduOrdinal(num)`

Converts a number to its Urdu ordinal form.

Parameter	Type	Description
`num`	`number`	The number to convert (1-100).

Returns: string — The Urdu ordinal word.

Numbering System

This package uses the South Asian numbering system used in Pakistan, India, Bangladesh, and Nepal:

Value	Urdu	Transliteration	Western Equivalent
1	ایک	ek	one
10	دس	das	ten
100	سو	sau	hundred
1,000	ہزار	hazaar	thousand
1,00,000	لاکھ	lakh	hundred thousand
10,00,000	دس لاکھ	das lakh	million
1,00,00,000	کروڑ	crore	ten million
1,00,00,00,000	ارب	arab	billion
1,00,00,00,00,000	کھرب	kharab	hundred billion

Real-World Examples

Cheque Printing

const amount = 250750.50;
const inWords = toUrduWords(amount, { currency: true, appendOnly: true });
// "دو لاکھ پچاس ہزار سات سو پچاس روپے اور پچاس پیسے صرف"

const inDigits = toUrduDigits(amount);
// "۲۵۰۷۵۰.۵۰"

Invoice Line Item

function formatUrduAmount(amount: number): string {
  return `${toUrduDigits(amount)} (${toUrduWords(amount, { currency: true })})`;
}

formatUrduAmount(15000);
// "۱۵۰۰۰ (پندرہ ہزار روپے)"

Custom Currency

toUrduWords(1500, {
  currency: true,
  currencyName: "ڈالر",
  fractionalName: "سینٹ",
  appendOnly: true,
});
// "ایک ہزار پانچ سو ڈالر صرف"

Edge Cases Handled

toUrduWords(0);                    // "صفر"
toUrduWords(-1);                   // "منفی ایک"
toUrduWords(0.5, { currency: true }); // "صفر روپے اور پچاس پیسے"
toUrduWords(1000000);              // "دس لاکھ"
toUrduWords("999999999999");       // Handles large numbers via string input

TypeScript Support

Full TypeScript definitions are included out of the box:

import { toUrduWords, toUrduDigits, toUrduOrdinal } from 'urdu-number-words';
import type { UrduNumberOptions } from 'urdu-number-words';

const options: UrduNumberOptions = {
  currency: true,
  appendOnly: true,
};

const result: string = toUrduWords(5000, options);

Contributing

Contributions are welcome! Whether it's fixing an Urdu word, adding features, or improving docs.

# Clone the repo
git clone https://github.com/faakhir-habib/urdu-number-words.git
cd urdu-number-words

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

Please open an issue first to discuss what you'd like to change.

to-words — Multi-locale number to words
number-to-arabic-words — Arabic number words

License

Made with ❤️ in Pakistan 🇵🇰

If this package helped you, please ⭐ the repo!