206368 - JavaScript 1.5 Reference - Date

Status: VERIFIED FIXED

(Documentation Graveyard :: Web Developer, defect)

Description

[Bob Clary [:bc] (inactive)]

From Bug 70879#c2

More errata discovered:

(1) Date().setFullYear(yearValue[, monthValue, dayValue])

should read:

Date().setFullYear(yearValue[, monthValue[, dayValue]])

The dayValue argument is optional even if a monthValue argument is provided.

Similarly:

Date().setHours(hoursValue[, minutesValue[, secondsValue[, msValue]]]) 
Date().setMinutes(minutesValue[, secondsValue[, msValue]]) 
Date().setUTCFullYear(yearValue[, monthValue[, dayValue]]) 
Date().setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]]) 
	// note:  the method above in the syntax example is spelled setUTCHour
Date().setUTCMinutes(minutesValue[, secondsValue[, msValue]])
Date.UTC(year, month, day[, hrs[, min[, sec[, ms]]]]) 

(4) Date() page setMinutes link points to getSeconds target.

Comment 1

[Bob Clary [:bc] (inactive)]

(7) Date().toLocaleString() overrides Object().toLocaleString(); there is no 
mention of this in the Date().toLocaleString() section.

(8) Date() object page does not include documentation on:
	Date().toLocaleTimeString()
	Date().toLocaleDateString()

Comment 2

[Bob Clary [:bc] (inactive)]

The current version is located at:

http://elwood.netscape.com:10050/library/manuals/2000/javascript/1.5/reference/date.html

Fixed all but 7)

Phil, can you review by Wed/Thurs so I can push this on Friday? Thanks.

Comment 3

[Phil Schwartau]

Bob: looks good. I noticed these two points, however:


I. The setUTCHours() example is missing an 's' at the end of the method name:

                theBigDay.setUTCHour(8);


II. We are presenting the Date.UTC() method this way:

   Date.UTC(year, month, day[, hrs[, min[, sec[, ms]]]])

But ECMA says the |day| parameter to |Date.UTC()| is optional: 

   Date.UTC (year, month[, day[, hrs[, min[, sec[, ms ]]]]])

Comment 4

[Bob Clary [:bc] (inactive)]

Thanks. changes made to elwood. Will mark fixed when this goes out Friday.

Comment 5

[Bob Clary [:bc] (inactive)]

f

Comment 6

[Phil Schwartau]

Verified Fixed.

Bob - will we address 7) above, or let that go? Note the verbiage
would be the same as already exists for the date.toString() method -

Comment 7

[Bob Clary [:bc] (inactive)]

I will go ahead and fix it in my tree. If anyone would like to review the entire
reference and collect all such missing "overrides" I will add them but I don't
have time to do a full review at the moment.