Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-6282188

[Fmt-Nu]DecimalFormat - javadocs for section "Scientific Notation" and "Special Values" is not clear

XMLWordPrintable

    • generic
    • generic

      The following may not be an issue for someone who is very familiar with this, but for someone who may not know DecimalFormat very well, it can be very difficult to understand.

      In the "Scientific Notation" section of the javadocs for DecimalFormat, it is unclear as to what the "The minimum and maximum number of integer digits" are in regards to the pattern. There should be something in the begining of the section or doc that describes the minimum and the maximum number of integer digits is refering to the digits prior to the decimal in the pattern. With the minimum number being equal to the number of "0"s and the maximum equal to the number of "0"s and "#"s.

      Also, as part of the example given in the doc, "##0.#####E0", something like the following should be added to help clarify what minimum and maximum means in the example: "In this example, the minimum number of integer digits is 1("0") and the maximum is 3("##0").

      Also, in the section "Special Values", "NaN" should be "Not a number(NaN)".
      ###@###.### 2005-06-08 06:25:20 GMT
      ###@###.### 2005-06-08 06:39:14 GMT

            jlu Justin Lu
            sjchan Steven Chan (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: