1勤務の打刻 → 労働時間の内訳

出勤・休憩・中抜け・退勤の打刻から、1日の労働時間・深夜の時間・1日8時間を超えた分・休日の労働を出す。日付と深夜帯は日本時間で見て、打刻漏れや24時間を超える勤務は計算しない。

日付とタイムゾーン「1か月」などの定義

言語ごとの結果

正解表 21件のうち、正解と一致した件数です。

PHPPHP 8.4.26

よくある書き方4 / 21

直した書き方21 / 21

PythonPython 3.14.7

よくある書き方20 / 21

直した書き方21 / 21

GoGo 1.27.2

よくある書き方20 / 21

直した書き方21 / 21

JavaScriptNode 24.15.0

よくある書き方21 / 21

直した書き方21 / 21

JavaJava 21.0.12

よくある書き方21 / 21

直した書き方21 / 21

C#.NET 10.0.402

よくある書き方21 / 21

直した書き方21 / 21

RustRust 1.99.0

よくある書き方4 / 21

直した書き方21 / 21

RubyRuby 4.0.7

よくある書き方20 / 21

直した書き方21 / 21

KotlinKotlin 2.4.21

よくある書き方21 / 21

直した書き方21 / 21

SwiftSwift 6.3.3

よくある書き方21 / 21

直した書き方21 / 21

なぜ割れたのか

よくある書き方が落ちたケースを、原因ごとにまとめた解説です(2本)。書いてある「落ちた言語」が今回の検証結果と一致することを確かめてから載せています。

日付とタイムゾーン

PHP と Rust だけ、朝9時からの勤務を「深夜」に数え、夜10時からの勤務の深夜を0分にした

対象のケースc001c002c003c004c005c006c012c013c014ac014bc015ac015bc016c017ac018c019 落ちた言語PHPRust

9:00〜18:00(休憩 12:00〜13:00)の普通の勤務で、深夜の時間は0分のはずです。PHP と Rust は、これを 240分 と答えました。逆に 22:00〜23:30 の勤務(c003)は、全部が深夜なのに 0分 でした。21件中、計算しない打刻漏れ(c010)・24時間超(c011)・順番がおかしい打刻(c020a・c020b)の4件だけが通り、残りの17件は深夜の時間が違っていました。日本時間の早朝4:00に出勤した勤務(c017a)では、始業日まで前の日(日曜)にずれ、法定休日の勤務として数えました。

なぜずれたのか

どちらも、打刻の時刻を UTC(世界標準時) の時・分で見ていました。日本時間の 9:00 は UTC の 0:00 なので、9:00〜14:00 が UTC の 0:00〜5:00、つまり「深夜帯(22:00〜翌5:00)」に入ります。そこから休憩の1時間を除いて240分です。

PHP は、打刻を strtotime() で秒に直し、date() で時・分を取り出しました。

$m = (int) date('G', $t) * 60 + (int) date('i', $t);

date() が使うのは、PHP の設定 date.timezone です。OS の時刻の設定(TZ)は見ません。検証に使っているコンテナは OS を日本時間にしていますが、PHP の設定は UTC のままでした。

$ php -r 'var_dump(ini_get("date.timezone"), date_default_timezone_get(), getenv("TZ"));'
string(3) "UTC"
string(3) "UTC"
string(10) "Asia/Tokyo"

Rust の標準ライブラリには、日時の型として SystemTime(1970年からの秒)しかなく、タイムゾーンがありません。秒を 86400 で割った余りから時・分を出したので、いつでも UTC の時刻になりました。

動かす場所を UTC にすると、7言語が落ちた

ほかの8言語のうち、JavaScript・Java・Kotlin・C#・Swift の5言語は、日本時間で動かすと21件中21件でした。同じよくある書き方を、タイムゾーンを UTC にしたコンテナで回し直すと、結果は次のようになりました(2026-11-19)。

言語日本時間(本番と同じ)UTC
PHP・Rust21件中4件21件中4件
JavaScript・Java・Kotlin・C#・Swift21件中21件21件中4件
Go・Python・Ruby21件中20件21件中20件

JavaScript の getHours()、Java・Kotlin の ZoneId.systemDefault()、C# の DateTime.Parse、Swift の Calendar.current は、どれも動かす場所のタイムゾーンで時・分を出します。日本の手元では正しく、UTC のサーバーに置くと深夜の時間が9時間ずれる、という形で表に出ます。

Go・Python・Ruby が UTC でもほとんど通ったのは、打刻の文字列を読むと、書いてある時差(+09:00)を持ったままの値になるからです。ただし、これは「打刻に書いてある時差で見ている」だけです。決まりは「日本時間で見る」なので、同じ勤務を +00:00 で書いた打刻(c017b)では、この3言語もずれました(下の解説)。

どう直したか

時・分・曜日・日付を、設定のタイムゾーン(Asia/Tokyo)を明示して取り出しました。PHP は DateTimeImmutable に DateTimeZone を付けます。

(new DateTimeImmutable('@' . $ts))->setTimezone(new DateTimeZone('Asia/Tokyo'))->format('G');

Rust は、標準ライブラリにタイムゾーンの表が無いので、時差を表で持ちました(Asia/Tokyo は +9 時間)。直したあとは10言語とも、日本時間・UTC・ニューヨーク時間のコンテナと Mac の4か所で、21件中21件が一致しました。

日付とタイムゾーン

同じ勤務を +00:00 で書くと、Go・Python・Ruby は日曜の夜の勤務と数えた

対象のケースc017b 落ちた言語PHPPythonGoRustRuby

c017a と c017b は、同じ勤務です。日本時間の 2026-10-19(月)4:00 に出勤し、14:00 に退勤しました。c017a は打刻を +09:00(日本時間)で、c017b は +00:00(UTC)で書いています。

c017a  2026-10-19T04:00:00+09:00
c017b  2026-10-18T19:00:00+00:00

決まりは「日付・曜日・深夜帯は日本時間で見る」なので、答えはどちらも同じです。始業日は 10-19、月曜の workday で、深夜の時間は 4:00〜5:00 の60分、時間外は60分です。

Go・Python・Ruby は、c017a には正しく答え、c017b だけを間違えました。始業日を 10-18(日曜)とし、法定休日の勤務として540分を数えました。深夜の時間は360分、時間外は0分でした。

なぜずれたのか

3言語とも、打刻の文字列を読むと、書いてある時差を持ったままの値になります。その値から日付・曜日・時を取り出すと、書いてある時差での日付・曜日・時が出てきます。

$ python3 -c 'from datetime import datetime; t=datetime.fromisoformat("2026-10-18T19:00:00+00:00"); print(t.date(), t.strftime("%A"), t.hour)'
2026-10-18 Sunday 19

Go の time.Parse と Weekday()、Ruby の Time.parse と wday も同じで、「10/18(日)19時」になりました。動かす場所のタイムゾーンは関係なく、日本時間のコンテナでも UTC のコンテナでも同じ答えです。

日本時間で書いた打刻だけが来るうちは、書いてある時差=日本時間なので正しく動きます。端末やほかのシステムから UTC で書いた打刻が来たときに初めてずれます。

PHP と Rust もこのケースで落ちていますが、理由は上の解説と同じです(時刻をいつも UTC で見ているので、c017a と c017b のどちらも日曜の19時からの勤務と数えました)。

どう直したか

日付・曜日・時を取り出す前に、設定のタイムゾーン(Asia/Tokyo)に直しました。

$ python3 -c 'from datetime import datetime; from zoneinfo import ZoneInfo; t=datetime.fromisoformat("2026-10-18T19:00:00+00:00").astimezone(ZoneInfo("Asia/Tokyo")); print(t.date(), t.strftime("%A"), t.hour)'
2026-10-19 Monday 4

Go は time.LoadLocation("Asia/Tokyo") で得た場所を t.In() に渡し、Ruby は t.getlocal("+09:00") で同じ「10/19(月)4時」になりました(2026-11-19、日本時間と UTC のコンテナで確かめた)。直したあとは10言語とも、21件中21件が一致しています。

正解表と、よくある書き方の答え

正解は実装より先に決めて固定しています。右の欄は、よくある書き方の答えを言語ごとにまとめたものです(赤い値は実際に返した間違った答え)。

ケース入力正解よくある書き方の答え(10言語)
c001通常勤務(9:00-18:00・休憩60分) なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "office"}, {"type": "break_start", "at": "2026-10-14T12:00:00+09:00", "location": "office"}, {"type": "break_end", "at": "2026-10-14T13:00:00+09:00", "location": "office"}, {"type": "out", "at": "2026-10-14T18:00:00+09:00", "location": "office"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
480
break_minutes
60
away_minutes
0
night_minutes
0
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"office": 480}
flags
[]
  • PHP・Rustnight_minutes240
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c002残業あり(20:30退勤・1日8時間超) 690分 - 休憩60 = 630。630 - 480 = 150 なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "office"}, {"type": "break_start", "at": "2026-10-14T12:00:00+09:00", "location": "office"}, {"type": "break_end", "at": "2026-10-14T13:00:00+09:00", "location": "office"}, {"type": "out", "at": "2026-10-14T20:30:00+09:00", "location": "office"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
630
break_minutes
60
away_minutes
0
night_minutes
0
daily_overtime_minutes
150
legal_holiday_work_minutes
0
work_minutes_by_location
{"office": 630}
flags
[]
  • PHP・Rustnight_minutes240
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c003深夜のみ(22:00-23:30) 深夜帯の始まり 22:00 ちょうどは深夜に含む なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-14T22:00:00+09:00", "location": "home"}, {"type": "out", "at": "2026-10-14T23:30:00+09:00", "location": "home"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
90
break_minutes
0
away_minutes
0
night_minutes
90
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"home": 90}
flags
[]
  • PHP・Rustnight_minutes0
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c004日跨ぎ+深夜(在宅) 480分 - 休憩45 = 435。深夜帯 22:00-05:00 の420分から、深夜帯の中の休憩45分を引いて375。05:00-06:00 は深夜ではない。435 > 360 で必要な休憩は45分、足りている なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-15T22:00:00+09:00", "location": "home"}, {"type": "break_start", "at": "2026-10-16T01:00:00+09:00", "location": "home"}, {"type": "break_end", "at": "2026-10-16T01:45:00+09:00", "location": "home"}, {"type": "out", "at": "2026-10-16T06:00:00+09:00", "location": "home"}]
settings
{}
attributed_date
2026-10-15
day_type
workday
work_minutes
435
break_minutes
45
away_minutes
0
night_minutes
375
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"home": 435}
flags
[]
  • PHP・Rustnight_minutes0
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c005休憩なしの6時間超(9:00-16:00) 休憩は自動控除しない(break_mode: punch)。打刻どおりに計算し、不足の印だけ付ける なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "office"}, {"type": "out", "at": "2026-10-14T16:00:00+09:00", "location": "office"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
420
break_minutes
0
away_minutes
0
night_minutes
0
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"office": 420}
flags
["break_short"]
  • PHP・Rustnight_minutes300
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c006法定休日(日曜)の勤務 法定休日の労働は休日労働として別に数え、時間外には入れない なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-18T10:00:00+09:00", "location": "home"}, {"type": "break_start", "at": "2026-10-18T12:00:00+09:00", "location": "home"}, {"type": "break_end", "at": "2026-10-18T13:00:00+09:00", "location": "home"}, {"type": "out", "at": "2026-10-18T15:00:00+09:00", "location": "home"}]
settings
{}
attributed_date
2026-10-18
day_type
legal_holiday
work_minutes
240
break_minutes
60
away_minutes
0
night_minutes
0
daily_overtime_minutes
0
legal_holiday_work_minutes
240
work_minutes_by_location
{"home": 240}
flags
[]
  • PHP・Rustnight_minutes180
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c010打刻漏れ(退勤なし) 推測で退勤を補わない。計算せず印を付け、修正申請に回す
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "office"}, {"type": "break_start", "at": "2026-10-14T12:00:00+09:00", "location": "office"}, {"type": "break_end", "at": "2026-10-14T13:00:00+09:00", "location": "office"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
null
break_minutes
null
away_minutes
null
night_minutes
null
daily_overtime_minutes
null
legal_holiday_work_minutes
null
work_minutes_by_location
null
flags
["missing_out"]

✓10言語すべて正解

c011異常値(出勤から退勤まで25時間) 出勤から退勤までが max_span_minutes(1440)を超えたら計算しない。打刻ミスの可能性が高く、翌日の始業をまたぐ扱いも決まっていないため
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "office"}, {"type": "break_start", "at": "2026-10-14T12:00:00+09:00", "location": "office"}, {"type": "break_end", "at": "2026-10-14T13:00:00+09:00", "location": "office"}, {"type": "out", "at": "2026-10-15T10:00:00+09:00", "location": "office"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
null
break_minutes
null
away_minutes
null
night_minutes
null
daily_overtime_minutes
null
legal_holiday_work_minutes
null
work_minutes_by_location
null
flags
["over_24h"]

✓10言語すべて正解

c012うるう日の夜勤(2028-02-29 → 03-01) 月をまたいでも始業日(2月)に帰属する。深夜 420 - 休憩60 = 360 なぜ? 解説を読む
punches
[{"type": "in", "at": "2028-02-29T22:00:00+09:00", "location": "office"}, {"type": "break_start", "at": "2028-03-01T02:00:00+09:00", "location": "office"}, {"type": "break_end", "at": "2028-03-01T03:00:00+09:00", "location": "office"}, {"type": "out", "at": "2028-03-01T06:00:00+09:00", "location": "office"}]
settings
{}
attributed_date
2028-02-29
day_type
workday
work_minutes
420
break_minutes
60
away_minutes
0
night_minutes
360
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"office": 420}
flags
[]
  • PHP・Rustnight_minutes0
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c013中抜けあり(在宅・終業を繰り下げ) 630分 - 休憩60 - 中抜け90 = 480。中抜けを繰り下げた分は時間外にならない なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "home"}, {"type": "break_start", "at": "2026-10-14T12:00:00+09:00", "location": "home"}, {"type": "break_end", "at": "2026-10-14T13:00:00+09:00", "location": "home"}, {"type": "away_start", "at": "2026-10-14T15:00:00+09:00", "location": "home"}, {"type": "away_end", "at": "2026-10-14T16:30:00+09:00", "location": "home"}, {"type": "out", "at": "2026-10-14T19:30:00+09:00", "location": "home"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
480
break_minutes
60
away_minutes
90
night_minutes
0
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"home": 480}
flags
[]
  • PHP・Rustnight_minutes240
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c014a中抜けで法定休憩を満たす(away_counts_as_break: true) 420 > 360 で必要45分。休憩0 + 中抜け45 = 45 で足りる なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "home"}, {"type": "away_start", "at": "2026-10-14T12:00:00+09:00", "location": "home"}, {"type": "away_end", "at": "2026-10-14T12:45:00+09:00", "location": "home"}, {"type": "out", "at": "2026-10-14T16:45:00+09:00", "location": "home"}]
settings
{"away_counts_as_break": true}
attributed_date
2026-10-14
day_type
workday
work_minutes
420
break_minutes
0
away_minutes
45
night_minutes
0
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"home": 420}
flags
[]
  • PHP・Rustnight_minutes255
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c014b中抜けを休憩に数えない設定(away_counts_as_break: false) c014a と打刻は同じ。設定だけで印が変わり、労働時間は変わらない なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "home"}, {"type": "away_start", "at": "2026-10-14T12:00:00+09:00", "location": "home"}, {"type": "away_end", "at": "2026-10-14T12:45:00+09:00", "location": "home"}, {"type": "out", "at": "2026-10-14T16:45:00+09:00", "location": "home"}]
settings
{"away_counts_as_break": false}
attributed_date
2026-10-14
day_type
workday
work_minutes
420
break_minutes
0
away_minutes
45
night_minutes
0
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"home": 420}
flags
["break_short"]
  • PHP・Rustnight_minutes255
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c015a在宅→出社(移動を休憩で打刻) 移動時間を労働とするかは計算側で決めない。打刻どおり休憩として扱う なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "home"}, {"type": "break_start", "at": "2026-10-14T12:00:00+09:00", "location": "home"}, {"type": "break_end", "at": "2026-10-14T13:30:00+09:00", "location": "office"}, {"type": "out", "at": "2026-10-14T18:30:00+09:00", "location": "office"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
480
break_minutes
90
away_minutes
0
night_minutes
0
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"home": 180, "office": 300}
flags
[]
  • PHP・Rustnight_minutes210
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c015b在宅→出社(移動を労働のまま) 540分 - 休憩60 = 480。move は勤務状態を変えず場所だけ変える。移動中(13:00-14:00)は出発地 home に数え、home = 9-12 と 13-14 で240 なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "home"}, {"type": "break_start", "at": "2026-10-14T12:00:00+09:00", "location": "home"}, {"type": "break_end", "at": "2026-10-14T13:00:00+09:00", "location": "home"}, {"type": "move", "at": "2026-10-14T14:00:00+09:00", "location": "office"}, {"type": "out", "at": "2026-10-14T18:00:00+09:00", "location": "office"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
480
break_minutes
60
away_minutes
0
night_minutes
0
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"home": 240, "office": 240}
flags
[]
  • PHP・Rustnight_minutes240
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c016オフライン打刻(退勤が90分遅れて届いた) 計算は端末の打刻時刻(at)で行い、結果は c001 と同じ。受信との差が10分を超えたので印だけ付ける なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "home", "received_at": "2026-10-14T09:00:05+09:00"}, {"type": "break_start", "at": "2026-10-14T12:00:00+09:00", "location": "home", "received_at": "2026-10-14T12:00:03+09:00"}, {"type": "break_end", "at": "2026-10-14T13:00:00+09:00", "location": "home", "received_at": "2026-10-14T13:00:02+09:00"}, {"type": "out", "at": "2026-10-14T18:00:00+09:00", "location": "home", "received_at": "2026-10-14T19:30:00+09:00"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
480
break_minutes
60
away_minutes
0
night_minutes
0
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"home": 480}
flags
["clock_skew"]
  • PHP・Rustnight_minutes240
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c017a早朝出勤(月曜 4:00-14:00・休憩60分) 600分 - 休憩60 = 540。深夜は 04:00-05:00 の60分。540 - 480 = 60。日付・曜日・深夜帯は settings.timezone(Asia/Tokyo)で見る。UTC で見ると始業日が前日の日曜(法定休日)になり、深夜も 360 分になってしまう なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-19T04:00:00+09:00", "location": "office"}, {"type": "break_start", "at": "2026-10-19T08:00:00+09:00", "location": "office"}, {"type": "break_end", "at": "2026-10-19T09:00:00+09:00", "location": "office"}, {"type": "out", "at": "2026-10-19T14:00:00+09:00", "location": "office"}]
settings
{}
attributed_date
2026-10-19
day_type
workday
work_minutes
540
break_minutes
60
away_minutes
0
night_minutes
60
daily_overtime_minutes
60
legal_holiday_work_minutes
0
work_minutes_by_location
{"office": 540}
flags
[]
  • PHP・Rustattributed_date"2026-10-18"day_type"legal_holiday"night_minutes360daily_overtime_minutes0legal_holiday_work_minutes540
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c017b早朝出勤を UTC(+00:00)で書いた打刻 c017a と同じ時刻を UTC で書いたもの。答えは c017a と同じ。打刻に書かれた時差ではなく settings.timezone に直してから日付・曜日・深夜帯を見る なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-18T19:00:00+00:00", "location": "office"}, {"type": "break_start", "at": "2026-10-18T23:00:00+00:00", "location": "office"}, {"type": "break_end", "at": "2026-10-19T00:00:00+00:00", "location": "office"}, {"type": "out", "at": "2026-10-19T05:00:00+00:00", "location": "office"}]
settings
{}
attributed_date
2026-10-19
day_type
workday
work_minutes
540
break_minutes
60
away_minutes
0
night_minutes
60
daily_overtime_minutes
60
legal_holiday_work_minutes
0
work_minutes_by_location
{"office": 540}
flags
[]
  • PHP・Python・Go・Rust・Rubyattributed_date"2026-10-18"day_type"legal_holiday"night_minutes360daily_overtime_minutes0legal_holiday_work_minutes540
  • JavaScript・Java・C#・Kotlin・Swift✓ 正解
c018法定外休日(土曜)の勤務・1日8時間超 法定外休日(デモ会社は土曜・祝日)の労働は休日労働ではない。1日8時間超は workday と同じく時間外に数える(法定休日だけが時間外0・休日労働に別計上) なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-10-17T09:00:00+09:00", "location": "home"}, {"type": "break_start", "at": "2026-10-17T12:00:00+09:00", "location": "home"}, {"type": "break_end", "at": "2026-10-17T13:00:00+09:00", "location": "home"}, {"type": "out", "at": "2026-10-17T19:00:00+09:00", "location": "home"}]
settings
{}
attributed_date
2026-10-17
day_type
nonlegal_holiday
work_minutes
540
break_minutes
60
away_minutes
0
night_minutes
0
daily_overtime_minutes
60
legal_holiday_work_minutes
0
work_minutes_by_location
{"home": 540}
flags
[]
  • PHP・Rustnight_minutes240
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c019祝日(settings.public_holidays)の勤務 2026-11-03 は火曜。祝日は暦から推測せず settings.public_holidays に入っている日だけを祝日にする(既定は空なので、設定が無ければ workday) なぜ? 解説を読む
punches
[{"type": "in", "at": "2026-11-03T09:00:00+09:00", "location": "office"}, {"type": "break_start", "at": "2026-11-03T12:00:00+09:00", "location": "office"}, {"type": "break_end", "at": "2026-11-03T13:00:00+09:00", "location": "office"}, {"type": "out", "at": "2026-11-03T18:00:00+09:00", "location": "office"}]
settings
{"public_holidays": ["2026-11-03"]}
attributed_date
2026-11-03
day_type
nonlegal_holiday
work_minutes
480
break_minutes
60
away_minutes
0
night_minutes
0
daily_overtime_minutes
0
legal_holiday_work_minutes
0
work_minutes_by_location
{"office": 480}
flags
[]
  • PHP・Rustnight_minutes240
  • Python・Go・JavaScript・Java・C#・Ruby・Kotlin・Swift✓ 正解
c020a順番がおかしい打刻(休憩中に退勤) 休憩終了が無いまま退勤した。どこまでが休憩か推測しないで計算せず、印を付けて修正申請に回す
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "office"}, {"type": "break_start", "at": "2026-10-14T12:00:00+09:00", "location": "office"}, {"type": "out", "at": "2026-10-14T18:00:00+09:00", "location": "office"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
null
break_minutes
null
away_minutes
null
night_minutes
null
daily_overtime_minutes
null
legal_holiday_work_minutes
null
work_minutes_by_location
null
flags
["invalid_sequence"]

✓10言語すべて正解

c020b順番がおかしい打刻(時刻の逆行) 休憩終了(11:00)が休憩開始(12:00)より前。並べ替えて辻褄を合わせず、計算しないで印を付ける
punches
[{"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "office"}, {"type": "break_start", "at": "2026-10-14T12:00:00+09:00", "location": "office"}, {"type": "break_end", "at": "2026-10-14T11:00:00+09:00", "location": "office"}, {"type": "out", "at": "2026-10-14T18:00:00+09:00", "location": "office"}]
settings
{}
attributed_date
2026-10-14
day_type
workday
work_minutes
null
break_minutes
null
away_minutes
null
night_minutes
null
daily_overtime_minutes
null
legal_holiday_work_minutes
null
work_minutes_by_location
null
flags
["invalid_sequence"]

✓10言語すべて正解

コード

「違い」では、よくある書き方から直した書き方へ、どの行をどう変えたかを示しています(赤が消した行、緑が足した行、濃い色が行の中で変わった部分)。計算の部分だけを載せ、入出力を受け渡す部分は除いています。

WorkDay.php+15 −5よくある書き方(23b1e7f)→ 直した書き方

@@ 変更前 3行目〜 / 変更後 3行目〜 @@
33
44 /**
55 * 1勤務の打刻から労働時間の内訳を出す。
6− * v1: 打刻は strtotime() で秒に直し、時・曜日・日付は date('G')・date('w')・date('Y-m-d') で取る。
7− * 労働時間は「退勤 − 出勤 − 休憩 − 中抜け」、深夜帯は労働の区間を1分ずつたどって時刻で数える。
6+ * v2: 打刻は strtotime() で秒に直すところまでは v1 と同じ。時・曜日・日付は date() ではなく、
7+ * settings の timezone(Asia/Tokyo)を付けた DateTimeImmutable の format('G')・format('w')・format('Y-m-d') で取る。
8+ * v1(date('G', $ts) など)は Mac・コンテナ・コンテナ(TZ=UTC)の3か所とも15件中2件だった。date() は php.ini の
9+ * date.timezone(未設定なら UTC)で時刻を出すので、9:00〜18:00 の勤務が 0:00〜9:00 に見えて深夜帯に数えられ、
10+ * 22:00〜 の夜勤は 13:00〜 になって深夜が0分になった。OS の TZ(コンテナの既定は Asia/Tokyo)は効かない。
811 */
912 const WORKDAY_DEFAULTS = [
1013 'daily_limit_minutes' => 480,
@@ 変更前 37行目〜 / 変更後 40行目〜 @@
3740 return $ts;
3841 }
3942
43+function wallClock(int $ts, DateTimeZone $tz): DateTimeImmutable
44+{
45+ return (new DateTimeImmutable('@' . $ts))->setTimezone($tz);
46+}
47+
4048 function hhmm(string $s): int
4149 {
4250 [$h, $m] = explode(':', $s);
@@ 変更前 62行目〜 / 変更後 70行目〜 @@
6270 break;
6371 }
6472 }
65− $attributed = date('Y-m-d', $start);
66− $weekday = WEEKDAYS[(int) date('w', $start)];
73+ $tz = new DateTimeZone($s['timezone']);
74+ $attributed = wallClock($start, $tz)->format('Y-m-d');
75+ $weekday = WEEKDAYS[(int) wallClock($start, $tz)->format('w')];
6776 if ($weekday === $s['legal_holiday']) {
6877 $dayType = 'legal_holiday';
6978 } elseif (in_array($weekday, $s['nonlegal_holidays'], true)
@@ 変更前 125行目〜 / 変更後 134行目〜 @@
125134 foreach ($segments as [$a, $b, $loc]) {
126135 $byLoc[$loc] = ($byLoc[$loc] ?? 0) + intdiv($b - $a, 60);
127136 for ($t = $a; $t < $b; $t += 60) {
128− $m = (int) date('G', $t) * 60 + (int) date('i', $t);
137+ $lt = wallClock($t, $tz);
138+ $m = (int) $lt->format('G') * 60 + (int) $lt->format('i');
129139 if ($m >= $ns || $m < $ne) {
130140 $night++;
131141 }

仕様

着手前に確かめたこと(2026-11-19)

  • キザログの計算エンジン(PHP・Laravel)は、正解表6本の39件すべてを通っている(php artisan test --filter=CaseTable、この day の15件を含む)
  • 決まりだけから答えを出す別の計算(oracle.py)でも、15件中15件が正解表と一致した

写し直し(2026-11-19・version 2・21件)

  • 15件では、打刻がすべて +09:00 で出勤が9時以降だったため、始業日・曜日のずれと「打刻に書いてある時差のまま見る」間違いを見分けられなかった。キザログに依頼し、6件(c017a・c017b・c018・c019・c020a・c020b)が足された(キザログのコミット d27dbf7)。今の15件の id・入力・答えは変わっていない
  • キザログの計算エンジンは45件すべてを通った(php artisan test --filter=CaseTable。day の21件を含む)。oracle.py も21件中21件が一致した

入力

{
  "punches": [
    {"type": "in", "at": "2026-10-14T09:00:00+09:00", "location": "office"},
    {"type": "break_start", "at": "2026-10-14T12:00:00+09:00", "location": "office"},
    {"type": "break_end", "at": "2026-10-14T13:00:00+09:00", "location": "office"},
    {"type": "out", "at": "2026-10-14T18:00:00+09:00", "location": "office"}
  ],
  "settings": {}
}
項目説明
punches[].typein(出勤)・out(退勤)・break_start / break_end(休憩)・away_start / away_end(中抜け)・move(場所だけ変える)
punches[].at端末の打刻時刻。時差つきの ISO 8601。秒は 00(秒があれば呼び出し側の誤り)
punches[].locationoffice・home・satellite・direct
punches[].received_atサーバーが受け取った時刻(あれば)。秒があってもよい。計算には使わない
settings省略した項目は下の既定値

打刻は時刻の順に並んでいる。

既定値(デモ会社の就業規則・架空)

設定既定値意味
roundingnone丸めない(1分単位)
attributionstart_date日をまたいだ勤務は始業日に入れる
night_start / night_end22:00 / 05:00深夜帯(翌日の5:00まで)
daily_limit_minutes4801日8時間
legal_holidaysunday法定休日
nonlegal_holidayssaturday・public_holidays法定外休日
public_holidays[]祝日の一覧
break_rules360分を超えたら45分、480分を超えたら60分必要な休憩
away_counts_as_breaktrue中抜けを必要な休憩に数える
clock_skew_flag_minutes10打刻と受け取りが何分より離れたら印を付けるか
max_span_minutes1440出勤から退勤までがこれを超えたら計算しない
timezoneAsia/Tokyo日付・曜日・深夜帯を見るタイムゾーン

日付・曜日・深夜帯は、打刻に書いてある時差でも、動かす場所のタイムゾーンでもなく、timezone(日本時間)で見る。

計算

  1. 打刻を順にたどり、出勤→(休憩・中抜け・場所の変更)→退勤の区間に分ける。順番がおかしい打刻(休憩中に退勤・時刻の逆行など)があれば計算しない(invalid_sequence)
  2. 退勤が無ければ計算しない(missing_out)。出勤から退勤までが1440分を超えたら計算しない(over_24h)。推測で補わない
  3. 労働の区間の合計が work_minutes、休憩が break_minutes、中抜けが away_minutes。休憩は自動で引かない(打刻どおり)
  4. night_minutes は、労働の区間のうち日本時間の 22:00〜翌5:00 に入る分(22:00 ちょうどは入り、5:00 ちょうどは入らない)。深夜帯の中の休憩は入らない
  5. attributed_date は出勤の日本時間の日付。その日の曜日で day_type を決める(日曜は legal_holiday、土曜・祝日は nonlegal_holiday、ほかは workday)
  6. daily_overtime_minutes は 480分を超えた分。法定休日は 0 で、代わりに労働時間の全部を legal_holiday_work_minutes に入れる
  7. work_minutes_by_location は、労働の区間ごとに「その区間を始めた打刻の location」で足す。move は区間を区切って場所だけ変える
  8. 必要な休憩(work_minutes が360分超なら45分、480分超なら60分)に、休憩(away_counts_as_break なら中抜けも足す)が足りなければ break_short
  9. received_at と at の差が10分を超える打刻があれば clock_skew(計算の結果は変えない)

出力

成功したとき:

{"attributed_date": "2026-10-14", "day_type": "workday",
 "work_minutes": 480, "break_minutes": 60, "away_minutes": 0, "night_minutes": 0,
 "daily_overtime_minutes": 0, "legal_holiday_work_minutes": 0,
 "work_minutes_by_location": {"office": 480}, "flags": []}
  • 計算しないとき(missing_out・over_24h・invalid_sequence)は、attributed_date・day_type・flags だけを出し、ほかの7つは null
  • flags は break_short・missing_out・over_24h・invalid_sequence・clock_skew の順
  • 分はすべて整数

よくある書き方(v1)

その言語の標準の日時の型で打刻を読み、時・曜日・日付は標準の取り出し方(多くは動かす場所のタイムゾーン)で取り、労働時間は「退勤 − 出勤 − 休憩 − 中抜け」で出す、素直な書き方。深夜帯は時刻を見て数える。