What are the options for formatting a string? What are the options for formatting when using .ToString()?

What are the options for formatting a string? What are the options for formatting when using .ToString()?

If you are using the .NET Framework you probably know that it was designed to make your life easy. Many modern programming languages are catching up with the idea and providing many pre-built features to facilitate the regular needs of developers. One of those needs is proper formatting of a text/string. Whenever we need to display information to the user, we can’t show five percent as 0.05 nor ten thousand dollars as 10000. Because of that need for formatting the .NET framework provides us with standard formatting tools. We will cover in this article some of them and explain to the reader how to use them to facilitate the development work.

Standard Numeric Format String

As you probably realize, you can format dates, addresses, but most importantly for us now Numbers. The Standard numeric format strings are used to format a number in some of the most familiar representations:

• Currency
• Decimal
• Exponential (scientific)
• Fixed-point
• General
• Number
• Percent
• Round-trip
• Hexadecimal

In order to use this pre-configured formats, we are going to use the ToString method that has a format parameter, or you can also use it on methods such as Console.WriteLine and StringBuilder.AppendFormat. The other nice thing is that the format string takes the form A## where you can through the first part (“A”) specify the format and with the numeric portion (“##”) you can specify the precision. That way you can control how many digits in the string you want to show. It doesn’t perform any rounding, just truncates so take that into consideration and the accepted value range is from 0 to 99, with it using your culture/locale computer settings to determine the default value.

Below is a table obtained from MSDN with all the options for formatting using string.Format();. You can visit the website to obtain examples and additional information at (Standard numeric format strings):

Example:

using System;
using System.Globalization;
using System.Threading;

public class NumericFormats
{
   public static void Main()
   {
      // Display string representations of numbers for en-us culture
      CultureInfo ci = new CultureInfo("en-us");

      // Output floating point values
      double floating = 10761.937554;
      Console.WriteLine("C: {0}", 
              floating.ToString("C", ci));           // Displays "C: $10,761.94"
      Console.WriteLine("E: {0}", 
              floating.ToString("E03", ci));         // Displays "E: 1.076E+004"
      Console.WriteLine("F: {0}", 
              floating.ToString("F04", ci));         // Displays "F: 10761.9376"         
      Console.WriteLine("G: {0}",  
              floating.ToString("G", ci));           // Displays "G: 10761.937554"
      Console.WriteLine("N: {0}", 
              floating.ToString("N03", ci));         // Displays "N: 10,761.938"
      Console.WriteLine("P: {0}", 
              (floating/10000).ToString("P02", ci)); // Displays "P: 107.62 %"
      Console.WriteLine("R: {0}", 
              floating.ToString("R", ci));           // Displays "R: 10761.937554"            
      Console.WriteLine();

      // Output integral values
      int integral = 8395;
      Console.WriteLine("C: {0}", 
              integral.ToString("C", ci));           // Displays "C: $8,395.00"
      Console.WriteLine("D: {0}", 
              integral.ToString("D6", ci));          // Displays "D: 008395" 
      Console.WriteLine("E: {0}", 
              integral.ToString("E03", ci));         // Displays "E: 8.395E+003"
      Console.WriteLine("F: {0}", 
              integral.ToString("F01", ci));         // Displays "F: 8395.0"    
      Console.WriteLine("G: {0}",  
              integral.ToString("G", ci));           // Displays "G: 8395"
      Console.WriteLine("N: {0}", 
              integral.ToString("N01", ci));         // Displays "N: 8,395.0"
      Console.WriteLine("P: {0}", 
              (integral/10000.0).ToString("P02", ci)); // Displays "P: 83.95 %"
      Console.WriteLine("X: 0x{0}", 
              integral.ToString("X", ci));           // Displays "X: 0x20CB"
      Console.WriteLine();
   }
}