Amount in Words

Medium

text

formatting

Amount in Words

Your company prints checks, and the bank insists the amount appears in words next to the digits — 1234.56 on the amount line must read one thousand two hundred thirty-four and 56/100 on the words line. The check report needs a reusable converter, and you are writing it.

Requirements

Create a codeunit named "Amount In Words" with one public procedure:

procedure ToWords(Amount: Decimal): Text

Amount is a check amount: at least 0, below 1,000,000,000 (one billion), and never carrying more than two decimal places.

The returned text is the whole part spelled out in words, followed by the cents as a fraction:

The whole part is written in lowercase English words: 0–19 are single words (zero, one, … nineteen), round tens are single words (twenty, thirty, forty, fifty, sixty, seventy, eighty, ninety), and other two-digit numbers hyphenate the tens word and the units word (forty-two).
Hundreds read as the digit word plus hundred, then the remainder if any: 105 is one hundred five — no and inside the whole part; that word is reserved for the cents separator.
Millions and thousands read as their three-digit group (spelled per rules 1–2) followed by million or thousand. A group whose value is zero is omitted entirely: 1,000,000 is one million, 2,000,015 is two million fifteen.
A whole part of zero is the word zero.
After the whole part comes a space, the word and, a space, and the cents as exactly two digits over 100: 56/100, 05/100, 00/100. The fraction is always present, even for whole amounts.
Words are separated by single spaces, with no leading or trailing spaces.
An Amount below 0 or at/above 1,000,000,000 must raise an error with a message that contains the text out of range.

Examples: ToWords(1234.56) = one thousand two hundred thirty-four and 56/100; ToWords(0) = zero and 00/100; ToWords(0.99) = zero and 99/100.

What the tests check

The grading tests compare the returned text character for character against the rules above — spelling (it is forty, not fourty), hyphens, single spaces, lowercase, the zero-padded two-digit cents, and no and anywhere except before the fraction. They cover zero, the teens, round tens, compound tens, hundreds, amounts with skipped groups such as 1,000,000 and 2,000,015, the largest supported amount 999,999,999.99, and both out-of-range boundaries via the expected error. Several tests build their expected string from randomly generated digits, so hardcoding the example outputs will not pass.

Learn More

Hint 1

Split the whole part into three-digit groups — millions, thousands, and the rest. Each group is spelled the same way; only the scale word after it changes, and a group of zero contributes nothing.

Hint 2

The heart of the task is one helper that turns 1–999 into words: the hundreds digit plus the word hundred, then the remainder — a single word below 20, otherwise a tens word, and a hyphen plus unit word when the last digit isn't zero.

Hint 3

Convert the amount to integer cents once (multiply by 100 and round) — then dollars are cents div 100 and the fraction is cents mod 100, with no decimal drift. Pad the cents with a leading zero when below 10, and remember the case statement is your friend for the word tables.

ALBusiness Central 28.5

Press Compile to check your code compiles — Submit runs the tests.

The code editor is desktop-only

Open this problem on a computer to write and run code. Reading the description, tests and discussion works fine here.