How to convert a numeric value or currency to English words using C#

• Download demo project - 26 Kb

Introduction

After looking around the web for this functionality and failing to get an answer to my problem. I decided to spare some minutes and develop this functionality up to my requirement.

I've decided to share with developers out who may require it.

The program accepts numbers/numeric values as input and outputs an an English word representation.It accepts numbers ranging from 1 to some billions.

Here is the code:

using System;

namespace custom.util

public class NumberToEnglish

public String changeNumericToWords(double numb)

String num = numb.ToString();

return changeToWords(num, false);

public String changeCurrencyToWords(String numb)

return changeToWords(numb, true);

public String changeNumericToWords(String numb)

return changeToWords(numb, false);

public String changeCurrencyToWords(double numb)

return changeToWords(numb.ToString(), true);

private String changeToWords(String numb, bool isCurrency)

String val = "", wholeNo = numb, points = "", andStr = "", pointStr="";

String endStr = (isCurrency) ? ("Only") : ("");

try

int decimalPlace = numb.IndexOf(".");

if (decimalPlace > 0)

if (Convert.ToInt32(points) > 0)

andStr = (isCurrency)?("and"):("point");// just to separate whole numbers from points/cents

endStr = (isCurrency) ? ("Cents "+endStr) : ("");

val = String.Format("{0} {1}{2} {3}",translateWholeNumber(wholeNo).Trim(),andStr,pointStr,endStr);

catch { ;}

return val;

private String translateWholeNumber(String number)

string word = "";

try

bool beginsZero = false;//tests for 0XX

bool isDone = false;//test if already translated

double dblAmt = (Convert.ToDouble(number));

//if ((dblAmt > 0) && number.StartsWith("0"))

if (dblAmt > 0)

{//test for zero or digit zero in a nuemric

beginsZero = number.StartsWith("0");

int numDigits = number.Length;

int pos = 0;//store digit grouping

String place = "";//digit grouping name:hundres,thousand,etc...

switch (numDigits)

case 1://ones' range

isDone = true;

break;

case 2://tens' range

isDone = true;

break;

case 3://hundreds' range

place = " Hundred ";

break;

case 4://thousands' range

case 5:

case 6:

place = " Thousand ";

break;

case 7://millions' range

case 8:

case 9:

place = " Million ";

break;

case 10://Billions's range

place = " Billion ";

break;

//add extra case options for anything above Billion...

default:

isDone = true;

break;

if (!isDone)

{//if transalation is not done, continue...(Recursion comes in now!!)

//check for trailing zeros

if (beginsZero) word = " and " + word.Trim();

//ignore digit grouping names

if (word.Trim().Equals(place.Trim())) word = "";

catch { ;}

return word.Trim();

private String tens(String digit)

int digt = Convert.ToInt32(digit);

String name = null;

switch (digt)

case 10:

name = "Ten";

break;

case 11:

name = "Eleven";

break;

case 12:

name = "Twelve";

break;

case 13:

name = "Thirteen";

break;

case 14:

name = "Fourteen";

break;

case 15:

name = "Fifteen";

break;

case 16:

name = "Sixteen";

break;

case 17:

name = "Seventeen";

break;

case 18:

name = "Eighteen";

break;

case 19:

name = "Nineteen";

break;

case 20:

name = "Twenty";

break;

case 30:

name = "Thirty";

break;

case 40:

name = "Fourty";

break;

case 50:

name = "Fifty";

break;

case 60:

name = "Sixty";

break;

case 70:

name = "Seventy";

break;

case 80:

name = "Eighty";

break;

case 90:

name = "Ninety";

break;

default:

if (digt > 0)

name = tens(digit.Substring(0, 1) + "0") + " " + ones(digit.Substring(1));

break;

return name;

private String ones(String digit)

int digt = Convert.ToInt32(digit);

String name = "";

switch (digt)

case 1:

name = "One";

break;

case 2:

name = "Two";

break;

case 3:

name = "Three";

break;

case 4:

name = "Four";

break;

case 5:

name = "Five";

break;

case 6:

name = "Six";

break;

case 7:

name = "Seven";

break;

case 8:

name = "Eight";

break;

case 9:

name = "Nine";

break;

return name;

private String translateCents(String cents)

String cts = "", digit = "", engOne = "";

for (int i = 0; i < cents.Length; i++)

if (digit.Equals("0"))

engOne = "Zero";

else

cts += " " + engOne;

return cts;

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here