A DESCRIPTION OF THE PROBLEM : The javadoc contains: "The query will return one second of excess if it did adjust to remove the leap-second, and zero if not." this should be replaced with something like: "The query will return true if it did adjust to remove the leap-second, and false if not." URL OF FAULTY DOCUMENTATION : http://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html#parsedLeapSecond--