Korea working-hours calculator guide
This English page translates the Korean working-hours calculator and now calls shared pure functions in features/utilities/lib/working-hours-calculations. The Korean hook also uses the same functions, so daily pay, weekly stats, night work, holiday work, and monthly projection stay aligned.
Daily time calculation
The shared function parses start and end time, supports overnight shifts by rolling the end time into the next day, subtracts break minutes, and calculates total working minutes. Regular minutes are capped at 8 hours, while overtime minutes are the amount above 8 hours.
Night work is measured against the 22:00 to 06:00 window. If a break overlaps the night-work portion, the function deducts break time proportionally from night minutes, matching the original Korean hook logic.
Pay calculation
For non-holiday work, the calculator returns basic pay, overtime pay at 150%, night premium at 50%, and total pay. For holiday work, regular basic, overtime, and night pay are zeroed and holiday pay is calculated separately.
Holiday work within 8 hours is calculated at 150% of hourly wage. Holiday work above 8 hours is calculated with the Korean source split of 8 hours at 150% and excess hours at 200%.
Weekly and monthly stats
The weekly function loops through seven daily work inputs, calculates each workday, sums regular, overtime, night, holiday hours, and total pay, then checks the 52-hour weekly limit. Non-workdays are kept in the daily breakdown with zero pay.
The monthly projection is intentionally simple, using 22 workdays from the Korean hook. Because that logic is now in a lib file, both Korean and English pages can share the same behavior and tests can verify function reuse.
Use limits
Actual payroll can change based on ordinary wage definition, fixed overtime allowance, comprehensive wage agreements, substitute holidays, flexible work systems, and company rules. The calculator is a time-and-pay estimate, not a final payroll statement.
The important i18n change is structural: the English page calls the same working-hours calculation path that the Korean hook uses, including overnight time, night premium, holiday premium, and weekly-limit logic.