| APIs that accept a `java.time.Duration` or `java.time.Instant` should be |
| preferred, when available. |
| |
| JodaTime is now considered a legacy library for Java 8+ users. |
| |
| Representing date/time concepts as numeric primitives is strongly discouraged |
| (e.g., `long timeout`). |
| |
| APIs that require a `long, TimeUnit` pair suffer from a number of problems |
| |
| 1. they may require plumbing 2 parameters through various layers of your |
| application |
| |
| 2. overflows are possible when doing duration math |
| |
| 3. they lack semantic meaning (when viewed separately) |
| |
| 4. decomposing a duration into a `long, TimeUnit` is dangerous because of unit |
| mismatch and/or excessive truncation. |
