ticket:10017: Update Documentation in TimePeriod to reflect latest API proposal.

git-svn-id: http://source.icu-project.org/repos/icu/icu4j/branches/tkeep@33597 251d0590-4201-4cf1-90de-194747b24ca1