Class Formats


  • public class Formats
    extends java.lang.Object
    Functions for formatting numeric values.
    Since:
    2 Sep 2004
    Author:
    Mark Taylor (Starlink)
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.lang.String formatDecimal​(double value, int dp)
      Turns a floating point value into a string with a given number of decimal places using standard settings.
      static java.lang.String formatDecimal​(double value, java.lang.String format)
      Turns a floating point value into a formatted string using standard settings.
      static java.lang.String formatDecimalLocal​(double value, int dp)
      Turns a floating point value into a string using current locale settings.
      static java.lang.String formatDecimalLocal​(double value, java.lang.String format)
      Turns a floating point value into a formatted string using current locale settings.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • formatDecimal

        public static java.lang.String formatDecimal​(double value,
                                                     int dp)
        Turns a floating point value into a string with a given number of decimal places using standard settings.
        Parameters:
        value - value to format
        dp - number of decimal places (digits after the decmal point)
        Returns:
        formatted string
        Examples:
        formatDecimal(PI,0) = "3.", formatDecimal(0,10) = ".0000000000", formatDecimal(E*10,3) = "27.183"
      • formatDecimalLocal

        public static java.lang.String formatDecimalLocal​(double value,
                                                          int dp)
        Turns a floating point value into a string using current locale settings. For instance if language is set to French, decimal points will be represented as a comma "," instead of a full stop ".". Otherwise behaves the same as the corresponding formatDecimal function.
        Parameters:
        value - value to format
        dp - number of decimal places (digits after the decmal point)
        Returns:
        formatted string
        Examples:
        formatDecimal(PI,0) = "3,", formatDecimal(0,10) = ",0000000000", formatDecimal(E*10,3) = "27,183"
      • formatDecimal

        public static java.lang.String formatDecimal​(double value,
                                                     java.lang.String format)
        Turns a floating point value into a formatted string using standard settings. The format string is as defined by Java's java.text.DecimalFormat class.
        Parameters:
        value - value to format
        format - format specifier
        Returns:
        formatted string
        Examples:
        formatDecimal(99, "#.000") = "99.000", formatDecimal(PI, "+0.##;-0.##") = "+3.14"
      • formatDecimalLocal

        public static java.lang.String formatDecimalLocal​(double value,
                                                          java.lang.String format)
        Turns a floating point value into a formatted string using current locale settings. For instance if language is set to French, decimal points will be represented as a comma "," instead of a full stop ".". Otherwise behaves the same as the corresponding formatDecimal function.
        Parameters:
        value - value to format
        format - format specifier
        Returns:
        formatted string
        Examples:
        formatDecimal(99, "#.000") = "99,000", formatDecimal(PI, "+0.##;-0.##") = "+3,14"