A practical QA checklist to fix recurring date-math bugs in backend systems

A software engineer has outlined a recurring bug pattern found across fintech, healthcare, and HR codebases, where age or duration calculations are implemented incorrectly. The most common mistake involves subtracting birth years without accounting for whether the birthday has occurred yet in the current year, causing errors for edge cases like leap-year birthdays. The article distinguishes between two types of date calculations — age in full years and duration-threshold checks — arguing that conflating them is the root cause of most such bugs. Engineers are advised to use fixture-driven tests with explicit ISO-8601 date strings covering at least eight boundary cases, including February 29 birthdays and year-boundary scenarios. A key recommendation is to inject the reference date as a parameter rather than letting functions internally call the current time, making the logic both testable and deterministic.