Stdlib: IntlTimeZone::getUnknown()/getUTC()/createEnumeration()/getIDForWindowsID() missing after #20769 (ext/intl/timezone)

[PurHur]

Category

stdlib · php-src-strict · ext/intl IntlTimeZone catalog / identity API

Problem

After #6151 / #20769, VM (PROFILE=8.4) has a usable IntlTimeZone core (createTimeZone, createDefault, getGMT, getID, getOffset, getRawOffset, getDisplayName, getDSTSavings, getCanonicalID, getRegion, hasSameRules, toDateTimeZone, useDaylightTime). Sibling #20824 already tracks countEquivalentIDs / getEquivalentID / getTZDataVersion / getWindowsID.

Separately, php-src still exposes static catalog / sentinel helpers and Windows↔Olson reverse mapping that remain undefined — do not duplicate #20824.

Repro	Zend (intl)	VM PROFILE=8.4 (2026-07-19)
method_exists('IntlTimeZone', 'getGMT') / createTimeZone	true	true
method_exists('IntlTimeZone', 'getUnknown')	true	false
method_exists('IntlTimeZone', 'getUTC')	true (PHP 8.4+)	false
method_exists('IntlTimeZone', 'createEnumeration') / createTimeZoneIDEnumeration	true	false
method_exists('IntlTimeZone', 'getIDForWindowsID')	true	false
method_exists('IntlTimeZone', 'getErrorCode') / getErrorMessage	true	false
countEquivalentIDs / getWindowsID / …	tracked in #20824	—

php-src reference

• php/php-src ext/intl/timezone/timezone.stub.php
• php/php-src ext/intl/timezone/timezone_methods.cpp — getUnknown, getUTC, createEnumeration, getIDForWindowsID, error getters

PHP implementation target

• Extend ext/intl/VmIntlTimeZone.php method registration (same pattern as getGMT / createDefault)
• getUnknown / getUTC: return sentinel zone objects (ICU Etc/Unknown / UTC)
• createEnumeration / createTimeZoneIDEnumeration: return iterable/array of IDs consistent with available zone catalog already used by createTimeZone
• getIDForWindowsID: Windows→Olson map (subset OK if documented); pair with Stdlib: IntlTimeZone::countEquivalentIDs()/getEquivalentID()/getTZDataVersion()/getWindowsID() missing after #20769 (ext/intl/timezone) #20824 getWindowsID when both land
• Error getters via IntlError — no new C in runtime/
• Leave Stdlib: IntlTimeZone::countEquivalentIDs()/getEquivalentID()/getTZDataVersion()/getWindowsID() missing after #20769 (ext/intl/timezone) #20824 methods to that issue

Repro

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
cat > /tmp/tz_catalog_gap.php << "PHP"
<?php
foreach (["getGMT","getUnknown","getUTC","createEnumeration","createTimeZoneIDEnumeration","getIDForWindowsID","getErrorCode","getErrorMessage","countEquivalentIDs","getWindowsID"] as $m) {
  echo "$m=" . (method_exists("IntlTimeZone", $m) ? "yes" : "no") . "\n";
}
PHP
PHP_COMPILER_PROFILE=8.4 php bin/vm.php /tmp/tz_catalog_gap.php'

Observed (2026-07-19):

getGMT=yes
getUnknown=no
getUTC=no
createEnumeration=no
createTimeZoneIDEnumeration=no
getIDForWindowsID=no
getErrorCode=no
getErrorMessage=no
countEquivalentIDs=no
getWindowsID=no

(countEquivalentIDs/getWindowsID → #20824)

Done when

• getUnknown / getUTC return usable IntlTimeZone objects; createEnumeration yields IDs; getIDForWindowsID matches Zend for common Windows IDs (or documented subset)
• Error getters work; compliance under test/compliance/cases/intl/
• php-src-strict; no overlap regression with Stdlib: IntlTimeZone::countEquivalentIDs()/getEquivalentID()/getTZDataVersion()/getWindowsID() missing after #20769 (ext/intl/timezone) #20824; no new C in runtime/

[PurHur]

claim: PHP Compiler STD Lib Advanced — batch (#20836 → #20851 → #20852 → #20824 → #20853). Queued after #20836.

[PurHur]

Merged via #20870

Verification

• issue repro: getUnknown/getUTC/createEnumeration/getIDForWindowsID/error getters present; unknown=Etc/Unknown; utc=UTC; count=419; est=America/New_York
• vendor/bin/phpunit --filter intltz_catalog_20852 → OK (VM+JIT)

Batch progress: #20836, #20851, #20852 merged this run. Next: #20824 / #20853.

[PurHur]

claim: PHP Compiler STD Lib Advanced — implementing #20852 now (after #20851/#20869 merged).