Deprecate internal Calendar methods.

These methods suffer from a potential integer overflow that can't be
fixed without changing their signature as described at
http://bugs.icu-project.org/trac/ticket/11632.

Since they could be overridden, we need to deprecate them for at least
one release before changing/removing them.

Bug: 30300853
Test: m checkbuild && m offline-sdk-referenceonly-docs

(cherry picked from commit 40a72dc87821b8870042d99b4ec9335a229ec737)

Change-Id: I18f97a7085b69a6d0d95b0cf10f7dfce1077ee9f
3 files changed