Ukrainian Number to Words in JavaScript (uk-UA)

Use uk-UA when your application needs Ukrainian number words with gender-aware forms and Hryvnia currency wording for Ukrainian invoices or legal documents.

Locale codes: uk-UA · Numbering system: Short scale · Currency: Гривня (Hryvnia) / Копійка (Kopek) · Script: Cyrillic

Install

npm install to-words

Basic Conversion

import { ToWords } from 'to-words';

const tw = new ToWords({ localeCode: 'uk-UA' });

tw.convert(100);
tw.convert(1000);
tw.convert(1000000);

Currency - Hryvnia / Kopek

tw.convert(1234.56, { currency: true });
tw.convert('500.00', { currency: true, includeZeroFractional: true });

Gender

Ukrainian has grammatical gender. Pass gender in options when the noun context requires it.

tw.convert(1, { gender: 'masculine' });
tw.convert(1, { gender: 'feminine' });

Ordinal Numbers

tw.toOrdinal(1);
tw.toOrdinal(10);
tw.toOrdinal(100);

Locale Codes

Locale code	Country	Currency	Notes
uk-UA	Ukraine	Гривня / Копійка	Cyrillic script; gender-aware forms

Related

• Currency guide
• Gender guide
• Russian
• Belarusian
• All locales

FAQ

Q: Which locale code should I use for Ukrainian number-to-words output? Use uk-UA.

Q: Does uk-UA support grammatical gender? Yes. Pass gender: 'masculine' or gender: 'feminine' in the options object.

Q: Does uk-UA work for Hryvnia and Kopek currency output? Yes. Ukrainian currency wording is built into the locale configuration.