— Scott McNealy, Sun Microsystems Chairman, President and ceo

306
 
chapter 10
Highlights of the Calendar API
We just worked through using a few of the fi elds and 
methods in the Calendar class. This is a big API, so 
we’re showing only a few of the most common fi elds 
and methods that you’ll use. Once you get a few of 
these it should be pretty easy to bend the rest of the 
this API to your will.
Key Calendar Methods
add(int fi eld, int amount)
 
get(int fi eld)
getInstance()
getTimeInMillis()
roll(int fi eld, boolean up)
set(int fi eld, int value)
set(year, month, day, hour, minute) 
 (all ints)
setTimeInMillis(long millis)
// more...
Adds or subtracts time from the cale
ndar’s field.
Returns the value of the given calen
dar field.
Returns this Calendar’s time in millis
, as a long.
Adds or subtracts time without chan
ging larger fields.
Sets the value of a given Calendar fie
ld.
A common variety of set to set a com
plete time.
Sets a Calendar’s time based on a lo
ng milli-time.
Returns a Calendar, you can specify a
locale.
Key Calendar Fields
DATE / DAY_OF_MONTH
 
HOUR / HOUR _OF_DAY
 
MILLISECOND
MINUTE
MONTH
YEAR
ZONE_OFFSET
// more...
Get / set the day of month
Get / set the 12 hour or 24 hour valu
e.
Get / set the minute.
Get / set the month.
Get / set the year.
Get / set raw offset of GMT in millis
.
Get / set the milliseconds.
Calendar 
API

---

numbers 
and
statics