IntlTwelveHourFieldUsedForTwentyFourHourTime

warning native on by default quick-fix PHP ≥ 5.5

Group: Probable bugs

Use the 24-hour calendar field.

Example

<?php
$c = IntlCalendar::createInstance(); $c->set(IntlCalendar::FIELD_HOUR, 19);

Reported:

• line 2: Use the 24-hour calendar field.

Detection

• Report resolved IntlCalendar::set with direct builtin FIELD_HOUR class constant and proven integer value 12 through 23. FIELD_HOUR_OF_DAY, other fields and unknown values are excluded.
• Resolve builtin functions, extension classes, method receivers, constants and named arguments. Follow unchanged locals and aliases only within the same bounded lexical scope. Require a reachable path; merge branch facts only when all incoming paths establish them.
• Emit one finding at the violating operation, not one per evidence statement. Rebinding, writes, by-reference escape, unresolved calls that can mutate relevant state, and exhausted analysis budgets remove proof.
• D4. A value passed as a local variable is proven only while plain assignments are the sole way that variable changes in its scope. Anywhere in the same scope, an increment or decrement of the variable, a catch clause binding it, or a closure importing it by reference removes proof regardless of position, so the hour is treated as unknown. Closures importing it by value and arrow functions work on a copy and do not count.

Exceptions (no report)

• Exclude shadowed builtins, unresolved receivers, incomplete syntax and unknown prerequisite facts. An extension function name alone does not prove an application function is that builtin.
• A dominating valid guard or repair described in Detection prevents the finding. Both legacy noinspection and custos-ignore forms suppress this ID.
• No report when the hour variable is stepped or shared as described in D4: $h = 12; $h--; leaves 11, a valid 12-hour value, and renaming the field would move the time by twelve hours.

Fix

Replace only the FIELD_HOUR class constant name with FIELD_HOUR_OF_DAY on the same resolved class qualifier; retain qualifier and all other arguments.

All edits use exact byte ranges and preserve comments and evaluation order. Offer no fix when its stated prerequisites cannot be proven or the replacement is unsupported by the configured PHP version.

PHP versions

Requires PHP 5.5 or later and the referenced extension API. Respect method-specific introduction versions within PHP 5.3–8.5; unsupported optional APIs cannot establish facts. Named arguments require PHP 8.0 or later.

Configure

In custos.json:

{
  "rules": {
    "IntlTwelveHourFieldUsedForTwentyFourHourTime": {
      "enabled": false
    }
  }
}

Suppress

Before the statement or declaration (or the first statement of the file):

// @custos-ignore IntlTwelveHourFieldUsedForTwentyFourHourTime