I have read the API for the Date handling classes but have on many an occasion found them lacking information. For example when I change the timezone on a Calendar object why does it not adjust the result of getTime()? Also they fail to explain when it is appropriate to use a Date object or a Calendar object. Sun has gone to the trouble of deprecating most of the methods in the Date class yet continue to enforce its use through the DateFormat class.