anynum

anynum

Normalize Unicode decimal digits and minus signs to ASCII.

Converts digits from any script — Devanagari, Arabic-Indic, Thai, Bengali, Fullwidth, and 50+ others — to their ASCII equivalents (0–9). Also normalizes Unicode minus variants (−, －, ﹣) to ASCII -.

Pairs naturally with strnum — use anynum to normalize first, then strnum to detect the numeric type.

import anynum from 'anynum';

anynum('१२.३४')     // → '12.34'   (Devanagari)
anynum('٣٫١٤')     // → '3.14'    (Arabic-Indic)
anynum('−४२')      // → '-42'     (Unicode minus + Devanagari)
anynum('－９９.５') // → '-99.5'   (Fullwidth minus + Fullwidth digits)
anynum('hello')    // → 'hello'   (no digits — zero allocation)
anynum('100')      // → '100'     (already ASCII — zero allocation)

Install

npm install anynum

Usage

// ESM
import anynum from 'anynum';
import { anynum } from 'anynum';

API

anynum(str: string): string

• Accepts a string, returns a string.
• Non-string values are returned as-is (no throw).
• Non-digit characters pass through unchanged.
• If no conversion is needed, the original string is returned (zero allocation).

What gets converted

Decimal digits

Any Unicode character in category Nd (decimal digit) is mapped to its ASCII equivalent. This covers all positional decimal digit scripts — every script whose digits represent 0–9 by position.

anynum('๑๒๓')   // Thai        → '123'
anynum('੧੨੩')   // Gurmukhi   → '123'
anynum('᠑᠒᠓')   // Mongolian  → '123'
anynum('𝟏𝟐𝟑')   // Math Bold  → '123'

Unicode minus variants

Three Unicode characters are normalized to ASCII - (U+002D):

Code point	Character	Name
U+2212	−	MINUS SIGN (mathematical)
U+FF0D	－	FULLWIDTH HYPHEN-MINUS
U+FE63	﹣	SMALL HYPHEN-MINUS

Dashes used for punctuation — EN DASH (–), EM DASH (—), HYPHEN (‐) — are intentionally not converted.

anynum('−42')   // U+2212 MINUS SIGN      → '-42'
anynum('－42')  // U+FF0D FULLWIDTH        → '-42'
anynum('–42')   // U+2013 EN DASH          → '–42'  (unchanged)

Use with strnum

anynum and strnum compose cleanly:

import anynum from 'anynum';
import strnum from 'strnum';

strnum(anynum('१२.३४'))   // → 12.34  (number, float)
strnum(anynum('−४२'))     // → '-42'  (string; strnum handles sign detection)
strnum(anynum('hello'))   // → 'hello'

Supported scripts

50+ decimal digit scripts from Unicode Nd category, including:

Script	Zero	Sample
Devanagari (Hindi/Marathi/Nepali)	U+0966	०१२३४५६७८९
Arabic-Indic	U+0660	٠١٢٣٤٥٦٧٨٩
Extended Arabic-Indic (Urdu/Persian)	U+06F0	۰۱۲۳۴۵۶۷۸۹
Bengali	U+09E6	০১২৩৪৫৬৭৮৯
Gurmukhi	U+0A66	੦੧੨੩੪੫੬੭੮੯
Gujarati	U+0AE6	૦૧૨૩૪૫૬૭૮૯
Odia	U+0B66	୦୧୨୩୪୫୬୭୮୯
Tamil	U+0BE6	௦௧௨௩௪௫௬௭௮௯
Telugu	U+0C66	౦౧౨౩౪౫౬౭౮౯
Kannada	U+0CE6	೦೧೨೩೪೫೬೭೮೯
Malayalam	U+0D66	൦൧൨൩൪൫൬൭൮൯
Thai	U+0E50	๐๑๒๓๔๕๖๗๘๙
Lao	U+0ED0	໐໑໒໓໔໕໖໗໘໙
Tibetan	U+0F20	༠༡༢༣༤༥༦༧༨༩
Myanmar	U+1040	၀၁၂၃၄၅၆၇၈၉
Khmer	U+17E0	០១២៣៤៥៦៧៨៩
Mongolian	U+1810	᠐᠑᠒᠓᠔᠕᠖᠗᠘᠙
Fullwidth (CJK context)	U+FF10	０１２３４５６７８９
Mathematical Bold	U+1D7CE	𝟎𝟏𝟐𝟑𝟒𝟓𝟔𝟕𝟖𝟗
Adlam	U+1E950	𞥐𞥑𞥒𞥓𞥔𞥕𞥖𞥗𞥘𞥙
… and 30+ more

What it does NOT convert

• Kanji/Chinese numeral words (三, 百, 万) — these are ideographic numerals, not decimal digits. Each language has its own positional system requiring separate parsing logic.
• Roman numerals (Ⅳ, Ⅻ) — not decimal digits.
• Punctuation dashes (– EN, — EM, ‐ HYPHEN) — not numeric signs.
• Decimal separators — commas, periods, Arabic decimal comma (٫) are passed through as-is. Separator normalization is the caller's responsibility.

License

MIT