Gotcha: Java Calendar class returns 0-based month, but 1-based days

Just noticed that the Java Calendar class breaks the least-user-expected rule (that is don’t make something behave in the least expected way) regarding the indexing of the month value it returns, compared to all other indexed variables it can return (like day of year, day of month, day of week etc.). The former is using a 0-based index, whereas all the others are 1-based.

get

public int get(int field)

Returns the value of the given calendar field. In lenient mode, all calendar fields are normalized. In non-lenient mode, all calendar fields are validated and this method throws an exception if any calendar fields have out-of-range values. The normalization and validation are handled by the complete() method, which process is calendar system dependent.

Parameters:

field – the given calendar field.

Returns:

the value for the given calendar field.

MONTH

public static final int MONTH

Field number for get and set indicating the month. This is a calendar-specific value. The first month of the year in the Gregorian and Julian calendars is JANUARY which is 0; the last depends on the number of months in a year.

DATE

public static final int DATE

Field number for get and set indicating the day of the month. This is a synonym for DAY_OF_MONTH. The first day of the month has value 1.

DAY_OF_MONTH

public static final int DAY_OF_MONTH

Field number for get and set indicating the day of the month. This is a synonym for DATE. The first day of the month has value 1.

There is an interesting discussion about this at
http://stackoverflow.com/questions/344380/why-is-january-month-0-in-java-calendar

At http://imagej.1557.x6.nabble.com/month-of-the-macro-function-quot-getDateAndTime-quot-td4999707.html one reads that this confusing setting came from UNIX (similar to those silly command abbreviations [“creat” instead of “create” etc.):

The origins lie with the POSIX

standard functions |ctime|, |gmtime| and |localtime|, which accept or

return a |time_t| structure with the following fields (from man 3 ctime

<http://linux.die.net/man/3/ctime>):

|int tm_mday;    /* day of month (1 – 31) */

int tm_mon;     /* month of year (0 – 11) */

int tm_year;    /* year – 1900 */

|

This API was copied pretty much exactly into the Java Date class in Java

1.0, and from there mostly intact into the Calendar class in Java 1.1.

Sun fixed the most glaring problem when they introduced Calendar – the

fact that the year 2001 in the Gregorian calendar was represented by the

value 101 in their Date class. But I’m not sure why they didn’t change

the day and month values to at least both be consistent in their

indexing, either from zero or one. This inconsistency and related

confusion still exists in Java (and C) to this day.”

Κοινόχρηστο Ημερολόγιο (Group Calendar) με Microsoft Outlook ή Hotmail

1) Δημιουργείς ένα Windows Live Group:

http://explore.live.com/windows-live-groups-help-center

Επιλέγοντας να εγκρίνεις ποιοι γράφονται (να μην μπαίνουν στο group αυτόματα) αν έχει τέτοια επιλογή.  Μπορείς μετά να στείλεις προσκλήσεις εγγραφής στο group μέσω e-mail.

Στη συνέχεια φτιάχνουν Windows Live ID όσοι είναι να συμμετέχουν στο group για να βλέπουν το group calendar. Μπορούν να χρησιμοποιήσουν μια διεύθυνση @hotmail.com, @hotmail.gr κλπ. που παρέχει το Windows Live Hotmail δωρεάν ή το δικό τους e-mail συνδέοντας το με Windows Live ID στο http://www.passport.net (αν δεν έχουν ή δε θέλουν Hotmail αλλά μόνο Windows Live ID για να εισέρχονται σε υπηρεσίες της Microsoft όπως τα Windows Live Groups).

Έπειτα εγγράφονται στο group με το Windows Live ID τους

2) Όσοι έχουν hotmail μπορούν να το βλέπουν εναλλακτικά στο web στο ημερολόγιο του hotmail όπου δείχνει και τα ημερολόγια των group όπου είσαι εγγεγραμμένος.

3) Για όσους έχουν πρόσφατο Outlook (2007 και άνω), μπορούν να βλέπουν τοπικά το κοινόχρηστο ημερολόγιο εγκαθιστώντας το Outlook Social Connector

http://www.microsoft.com/download/en/details.aspx?id=7985

Αφού εγκατασταθεί το ρυθμίζεις με το e-mail που χρησιμοποίησες για να εγγραφείς στο Windows Live Group και στην περιοχή Calendar του Outlook έχει δυνατότητα να επιλέξεις να βλέπεις και το κοινόχρηστο Calendar (ή μόνο αυτό).

 

Αν πάλι διαθέτεις Windows Exchange Server μπορείς να χρησιμοποιήσεις αυτόν:

http://www.outlookipedia.com/outlook/group-calendar.aspx

ή κάποιες άλλες λύσεις τρίτων (εμπορικές)

http://www.outlookipedia.com/outlook/share-calendar.aspx#Group_Calendar_Solutions_for_Outlook

 

Τέλος, το παρακάτω δείχνει έναν τρόπο να κάνεις Group/Team Calendars χωρίς Exchange (π.χ. με κάποιο δικό σου web server):

http://www.commodore.ca/windows/shared_calendar/share_outlook_calendar.htm