Stdlib: ext/intl — IntlDateFormatter create/format (ext/intl/dateformat)

[PurHur]

Category

stdlib

Problem

There is no ext/intl in this repo. Zend exposes IntlDateFormatter (datefmt_create, format, locale/timezone) via ICU. Web and CLI code using localized date formatting fails with missing class/function.

php-src reference

• php/php-src ext/intl/dateformat/dateformat_class.c — IntlDateFormatter class
• php/php-src ext/intl/dateformat/dateformat_format.c — datefmt_format
• php/php-src ext/intl/dateformat/dateformat_create.c — datefmt_create
• php/php-src ext/intl/php_intl.h — module init
• Stub: php/php-src ext/intl/dateformat/dateformat.stub.php — constants SHORT, LONG, …

Repro (failure today)

<?php
$fmt = IntlDateFormatter::create(
    'en_US',
    IntlDateFormatter::SHORT,
    IntlDateFormatter::SHORT,
    null,
    IntlDateFormatter::GREGORIAN,
    'yyyy-MM-dd'
);
echo $fmt->format(new DateTime('2020-01-15 12:00:00'));

docker info >/dev/null
./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
php repro.php
php bin/vm.php repro.php
'

Check	Zend PHP 8.2 (icu)	bin/vm.php (today)
class_exists('IntlDateFormatter')	true	false
format(DateTime)	localized string (e.g. 1/15/20)	fatal / missing class

Scope (this repo)

Layer	Path	Notes
Module	ext/intl/Module.php (new)	Register class + IntlDateFormatter::* int constants
Class	ext/intl/IntlDateFormatter.php	PHP-first; ICU via thin FFI to ucal_* only if unavoidable — document in PR
Wire	lib/VM/BuiltinClasses.php, loader next to ext/standard/Module.php
DateTime	Depends on #5120 DateTime OOP surface
Tests	test/compliance/cases/stdlib/intl_dateformatter_short.phpt
Matrix	script/capability-matrix.php row

Out of scope: NumberFormatter (#5154), Normalizer (#5153), intl_get_error_* (#5156).

Done when

• Repro: IntlDateFormatter::create('en_US', SHORT, SHORT, …) returns object on VM
• format(new DateTime('2020-01-15')) matches Zend output for en_US SHORT/SHORT (normalize whitespace in test)
• class_exists('IntlDateFormatter') true when ext enabled
• ./script/ci-fast.sh --filter intl_dateformatter green
• Capability matrix updated via script/capability-matrix.php

Links

#5154, #5156, #5120, #1492

[PurHur]

Handoff (advanced stdlib batch): #19534, #19535, #19547 merged this run.

#5201 remains blocked on product/policy choice: IntlDateFormatter is gated behind advertisesBuiltins() → extension_loaded('intl') (always false while Module registers as standard). Filed child #implementation-ready issue for Normalizer-style partial advertise + PHP create/format subset — see newest linked child from this batch.

Next agent: claim the child issue (or flip policy + implement create/format in ext/intl/).

[PurHur]

Child filed: #19549 (partial IntlDateFormatter advertise + create/format).

[PurHur]

claim: PHP Compiler STD Lib Advanced — batch (issues #6151, #5154, #5201, #3336) — starting #6151 IntlCalendar/IntlTimeZone

[PurHur]

Closing — done-when satisfied on master

Verified 2026-07-16 after #19609 / current master tip.

IntlDateFormatter create/format

Pattern create/format green without ext/intl (#19549/#19583); class_exists true.

Not a new implementation PR — surface already landed; tracker cleanup for advanced-stdlib batch.