Cleanup of Calendar.java to prep for api

Added comments. Made internal only stuff private. Added @hide to
methods only used by the provider. Added/altered methods for
consistency across contract classes.

Change-Id: I4d810995042583f1ab05b859f320828f83329e90