DecimalFormat : Java Glossary

DecimalFormat

java.text.DecimalFormat is the class for turning numbers into Strings, nicely decorated with decimal points and commas. It can also be used to parse Strings back into binary numbers. It works with a String pattern to describe the format of a number. You can use it with doubles, floats, longs and ints. DecimalFormat automatically rounds output to the displayed number of decimal places.

Pattern Characters	Parsing
Forcing +	Learning More
Handling Negatives	Links
Post-Processing

Most Common DecimalFormat Pattern Characters

Most Common DecimalFormat Pattern Characters
Char	Meaning
0	digit or lead zeroes
#	digit or nothing at all. There is no pattern character to provide lead spaces for creating a fixed length pattern. It also works to the right of the decimal point. It also suppresses the decimal point to the left if there is no fractional part.
.	decimal point. Actual character displayed is locale-specific, though the character you specify for the pattern is always a dot, e. g. in Sweden this will display as a comma.
,	comma for grouping digits. Actual character displayed is locale-specific, though the character you specify for the pattern is always a docomma, e. g. in Sweden this will display as a period.
E	exponent separator.
'	used to surround decorative characters, including embedded spaces, e. g. "'$'###,##0.00"
;	Used to separate the pattern for positive numbers from the pattern for negative numbers.
%	display a ratio as a percentage. As in "##0.0%", multiplies the displayed value by 100 and displays a decorative trailing %.

Forcing +

Note there is no + pattern character to force an explicit positive sign. However you can get that effect using decorative + and - this way:

// Getting an explicit + - sign
// Formats 3.0 as "+3.0" and -3.0 as "-3.0".
// The surrounding ' are not needed in this case.
DecimalFormat explicitSign = new DecimalFormat( "'+'0.0;'-'0.0" );

Handling Negatives

Note that - is not used to arrange for a minus sign for negative numbers. That happens automatically.

You can say something like this to arrange for negative numbers to be shown in parentheses:

new DecimalFormat ( "#,##0.0#;(#,##0.0#)" );

Post-Processing

If DecimalFormat won’t do exactly what you want, don’t despair. Just add your own post-processing on the String it produces. Pad to fixed length with StringTools. leftPad or StringTools.rightPad or StringTools.toLZ. You can download the source for StringTools as part of the com.mindprod.common11 package.

Parsing

You can also use DecimalFormat to parse String to extract ints, longs and doubles you can compute

Learning More

When you study Sun’s documentation, don’t forget to look at NumberFormat, DecimalFormat’s abstract superclass. That’s where most of its useful methods are. DecimalFormat documents the magic characters you can use in pattern strings.

Oracle’s Javadoc on DecimalFormat class : available:

on the web at Oracle.com
in the current JDK 1.7.0_04 or in the old JDK 1.6.0_32 on your local Windows J: drive.

Oracle’s Javadoc on NumberFormat class : available:

on the web at Oracle.com
in the current JDK 1.7.0_04 or in the old JDK 1.6.0_32 on your local Windows J: drive.

Calendar: SimpleDateFormat
conversion
conversion table for Java 1.4-
conversion table for Java version 1.5 or later
Converter Amanuensis
floating point
NumberFormat
printf

	You can get the freshest copy of this page from:	or possibly from your local J: drive (Java virtual drive/mindprod.com website mirror)
	http://mindprod.com/jgloss/decimalformat.html	J:\mindprod\jgloss\decimalformat.html
	Please email your feedback for publication, letters to the editor, errors, omissions, typos, formatting errors, ambiguities, unclear wording, broken/redirected link reports, suggestions to improve this page or comments to Roedy Green : . If you want your message, your name or email kept confidential, not considered for public posting, please explicitly specify that. Unless you state otherwise, I will treat your message as a letter to the editor that I may or may not publish in the feedback section. After that, it will be too late to retract it. If you disagree with something I said, please quote it and cite the web page where you found it, tell me why you think it is wrong, and, if possible, provide some supporting evidence. Threatening to kill me or spouting obscenities has yet to persuade me to change my mind.
	Canadian Mind Products
	mindprod.com IP:[65.110.21.43]
view Blog	Your face IP:[38.107.179.211]
Feedback	You are visitor number 61,955.