Calendar is always bad practice.
Java has 3 to 4 APIs for time. In order of introduction:
- System.currentTimeMillis()
- (together with the above):
java.util.Date
and sometime later, java.sql.Timestamp
and Date. This is very bad API; at this point, almost all the methods in these are deprecated because they are misleading or straight up do not do what they suggest they do, and are in any case gigantic misnomers. j.u.Date
represents an instant in time, not readily representable in human terms. Dates are fundamentally human concepts.
- Calendar. An attempt to fix the problem. Actually made it worse: The API is misleading and surprising (.set(MONTH, 1) will set the month to.. Februari!), and is entirely non-idiomatic, using .set/.get with an extra parameter with a 'field' concept, and having mutable types). The actual representational power of this API is still limited.
- JSR310, a.k.a.
java.time
. THIS is the good one. This has few surprises, is complex where time ends up being actually complex, the types are properly named, going so far as having both j.t.Instant
and j.t.ZonedDateTime
, and you can express virtually anything date-related.
I'd say using either j.u.Date or Calendar is strongly dis-recommended. If all you're doing is measuring instants in time, feel free to stick with System.currentTimeMillis() - but if ever you need to print that in human form (such as: "On 2020-07-20 at 16:34, this happened"), switch to java.time
instead. If you prefer, feel free to ditch currentTimeMillis and use j.t.Instant
for those purposes instead - your preference.