What is LocalDate.getMonth().getValue() in Java?

Returns 1-12 for January-December, per ISO. Use -1 for zero-based arrays.

Why does Java Month enum have getValue() starting at 1?

For human intuition and ISO 8601 compliance, clashing with programmer zero-based habits from C/JS.

Not broken, but introduces off-by-one gotchas in month indexing—third attempt, same old fights.

Everyone thought Java's third date API would finally nail it. Nope—LocalDate's Month.getValue() just handed devs a fresh indexing nightmare.

theAIcatchup Apr 08, 2026 4 min read

LocalDate's Month.getValue() is 1-based, breaking zero-based array indexing traditions. 𝕏
Stick to ordinal() for legacy compatibility; subtract 1 from getValue() otherwise. 𝕏
Java's date APIs evolve, but pragmatic standards trump 'intuitive' changes every time. 𝕏

Published by

Community-driven. Code-first.

#Java LocalDate #Month enum bug #date api #java #java.time #java.time API #localdate #month enum #off-by-one error #programming-pitfalls

Get the best Open Source stories of the week in your inbox — no noise, no spam.

Originally reported by Dev.to