[deepsun]

I believe it was all clarified long ago in Java (Joda library, that was reimplemented in newer versions in core SDK as java.time).

[skilpat]

Indeed! That library, as incorporated into the jdk, seems to me like the gold standard of datetime programming in standard libraries. Good type-level distinctions, good defaults, good extensibility... chef kissing fingers

[reallydude]

Joda is clearer semantically, even today. The core just can't seem to get certain features right for developers.