Name: yyT116575 Date: 04/26/2001


java version "1.3.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.0)
Classic VM (build 1.3.0, J2RE 1.3.0 IBM build cx130-20001025 (JIT disabled))


The current javadoc for the DAY_OF_WEEK_IN_MONTH field is incorrect (incorrect
version shown below):

Field number for get and set indicating the ordinal number of the day of the
week within the current month. Together with the DAY_OF_WEEK field, this
uniquely specifies a day within a month. Unlike WEEK_OF_MONTH and
WEEK_OF_YEAR, this field's value does not depend on getFirstDayOfWeek() or
getMinimalDaysInFirstWeek(). DAY_OF_MONTH 1 through 7 always correspond to
DAY_OF_WEEK_IN_MONTH 1; 8 through 15 correspond to
DAY_OF_WEEK_IN_MONTH 2, and so on. DAY_OF_WEEK_IN_MONTH 0
indicates the week before DAY_OF_WEEK_IN_MONTH 1. Negative values
count back from the end of the month, so the last Sunday of a month is specified
as DAY_OF_WEEK = SUNDAY, DAY_OF_WEEK_IN_MONTH = -1. Because
negative values count backward they will usually be aligned differently within
the month than positive values. For example, if a month has 31 days,
DAY_OF_WEEK_IN_MONTH -1 will overlap DAY_OF_WEEK_IN_MONTH
5 and the end of 4.

--END--

The issue is with the phrase: "DAY_OF_MONTH 1 through 7 always
correspond to DAY_OF_WEEK_IN_MONTH 1; 8 through 15 correspond
to DAY_OF_WEEK_IN_MONTH 2, and so on."

This should read: "DAY_OF_MONTH 1 through 7 always correspond to
DAY_OF_WEEK_IN_MONTH 1; 8 through 14 correspond to
DAY_OF_WEEK_IN_MONTH 2, and so on."
as "8 through 15" implies an 8-day week :-)
(Review ID: 123303)
======================================================================