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

Doc: Error in Calendar class Documentation

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Cannot Reproduce
    • Icon: P4 P4
    • None
    • 1.1.6
    • core-libs



      Name: dg70945 Date: 09/23/98


      As stated in the JDK 1.1.6 Core API Specification:

      1. 24:00:00 "belongs" to the following day. That is, 23:59 on Dec 31, 1969 < 24:00 on Jan 1, 1970 < 24:01:00 on Jan 1, 1970

      This makes no sense. If 24:00:00 belongs to the following day, then what is meant here is the following:

      1. ...23:59 on Dec 31, 1969 < 24:00 on Dec 31, 1969 < 24:01:00 on Dec 31, 1969

      As it is currently stated in the documentation, doesn't 24:01:00 Dec 31, 1969 equal 00:01:00 Jan 1, 1970?
      This is extremely confusing, at any rate.

      ---------------------------------------
      Alan Liu (engineer) writes:

      The customer is right.

      The documentation should read:

       1. ...23:59 on Dec 31, 1969 < 24:00 on Dec 31, 1969 < 24:01:00 on Dec
      31, 1969

      Or maybe we should just say:

       24:01:00 Dec 31, 1969 equals 00:01:00 Jan 1, 1970

      which probably makes more sense to most people.

      -Alan


      (Review ID: 37215)
      ======================================================================

            okutsu Masayoshi Okutsu
            dgreensunw Dale Green (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: