TTS Verbalization Guide & Specifications for uk-UA

Product: uk-UA
Release Date: October 2026
TTS Engine version: 3.4.0

Introduction

This document describes how specific series of strings are read by the TTS Engine for the UK language in the UA domain. Example outputs are in Ukrainian (Cyrillic script). The readings are the engine's current output for the version above: when a reading is not what is wanted, this document still shows what the engine does.

Convention: every example table includes a Lexis voice output column. Any new row appears marked with 🆕. Missing support is shown as "unsupported". Numeric ranges use [a-b] (for example, [1-99] means any number from 1 to 99).

Readings are shown in lower case with punctuation as the engine returns it. Two markers appear in the readings: [pause] is a 0.025 s pause the Lexis voice puts between groups of digits, and [pause 0.2 s] is a fixed pause of 0.2 s.

Numbers

Integers

Format	Example input	Lexis
`[1-9][0-9]`	`25`	двадцять п'ять
`1[1-9]`	`13`	тринадцять
`[1-9][0-9]…[0-9]`	`159`	сто п'ятдесят дев'ять

No thousands delimiter is supported (see rules above). Max supported value: 999999999999, read as "дев'ятсот дев'яносто дев'ять мільярдів дев'ятсот дев'яносто дев'ять мільйонів дев'ятсот дев'яносто дев'ять тисяч дев'ятсот дев'яносто дев'ять". Beyond that, digits are spelled one by one.

Ordinal numbers

Format	Example input	Lexis
`[1-9]…[0-9]{-й}`	`1-й`	перший
`[1-9]…[0-9]{-а}`	`1-а`	1 а

Decimals

Decimal separator: comma or dot. The fraction is read as a number with its denominator.

Format	Example input	Lexis
`[1-9]…[0-9]<comma>[0-9]…[0-9]`	`2,4527`	дві цілих, чотири тисячі п'ятсот двадцять сім десятитисячних

Fractions and units

Format	Example input	Lexis
`[1-99]<slash>[1-99]`	`13/16`	тринадцять шістнадцятих
`[1-99]<slash>[1-99]`	`5/64`	п'ять шістдесят четвертих
`[1-99]<slash>[1-99]`	`45/2`	сорок п'ять других
`[1-31]<slash>[1-12]`	`3/5`	третього травня

A fraction is read as a date when both numbers are between 1 and 31 and at least one of them is between 1 and 12, in either order. For example, "1/2" is "першого лютого", "7/3" is "сьомого березня" and "31/12" is "тридцять першого грудня". Only fractions with 1–2 digit parts that cannot be a date are read as fractions (for example "13/16", "5/64", "45/2"). Negative fractions ("-2/3") and parts with 3 or more digits ("3/100") are not verbalized. Units are not verbalized with fractions or numbers in uk-UA.

Telephone numbers

Format	Example input	Lexis
`0[0-9]{2} [0-9]{3} [0-9]{2} [0-9]{2}`	`050 123 45 67`	п'ятдесят сто двадцять три сорок п'ять шістдесят сім

Combination of numbers and words

Format	Example input	Lexis
`[0-9]…[0-9]<dash>{word}`	`16-bit`	шістнадцять bit

Ratio and intervals

Format	Example input	Lexis
`[0-9]…[0-9]<colon>[0-9]…[0-9]`	`16:9`	шістнадцять дев'ять

Percentage

Example input	Lexis
`1%`	один відсотків
`2%`	два відсотків

Time

Format	Example input	Lexis
`[00-24]<colon>[00-59]<colon>[00-59]`	`12:11:01`	дванадцятій годині одинадцять хвилин і одна секунда

Date

Format	Example input	Lexis
`[2-31] {month} [0-9]{4} [р.]`	`14 травня 2022 р.`	чотирнадцятого травня, дві тисячі двадцять другого року р

Words

Abbreviations and spelling

Latin capital letters are spelled with English letter names written in Cyrillic; other words in capital letters are spelled too (e.g. ABC, JOHN). Single letters: A ей, B бі, C сі, D ді, E е, F еф, G джі, H ейч, I ай, J джей, K кей, L ел, M ем, N ен, O о, P пі, Q кйу, R ар, S ес, T ті, U ю, V ві, W даблйу, X екс, Y вай, Z зед.

URLs and e-mails

URLs

Format	Example input	Lexis
`(www)<dot>{word}<dot>{domain}`	`www.google.com`	www крапка google крапка ком

E-mails

Format	Example input	Lexis
`{word}@{word}<dot>{domain}`	`info@omilia.com`	ай ен еф о вушко: om ilia крапка ком
`{word}@{word}<dot>{domain}`	`info@abc.com`	ай ен еф о вушко: abc крапка ком

The part before "@" is spelled letter by letter and "@" is read "вушко".

Currency

Format	Example input	Lexis
`{amount} {symbol}`	`25,10 ₴`	двадцять п'ять гривень, десять копійок

Currency codes and symbols

Code	Lexis	Subdivision
`UAH`	одна гривня, одна копійка	дві гривні, п'ятдесят копійок

Symbol	Lexis
`$`	$1 -> один долар \| 1$ -> один долар \| 1 $ -> один долар; $2 -> два долари \| 2$ -> два долари \| 2 $ -> два долари

Punctuation and character processing

Supported characters

Char	Description	Used as/in	Lexis
`.`	period	sentence end / date separator / decimal separator	✅

Punctuation intonation

Char	Lexis effect
`.`	falling intonation
`?`	rising intonation for yes/no questions
`,`	falling intonation
`!`	a lone exclamation mark is rewritten as a full stop (falling intonation)
space / dash	short pause (a spaced dash is a fixed pause of 0.2 s)
no punctuation at the end of a sentence	a period is added automatically