PHPackages professional-wiki/edtf - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Parsing & Serialization](/categories/parsing) 4. / 5. professional-wiki/edtf ActiveLibrary[Parsing & Serialization](/categories/parsing) professional-wiki/edtf ====================== PHP library to parse, represent and work with dates that follow the Extended Date/Time Format specification. 3.1.0(7mo ago)10432.1k—3.5%7[14 issues](https://github.com/ProfessionalWiki/EDTF/issues)[2 PRs](https://github.com/ProfessionalWiki/EDTF/pulls)4GPL-2.0-or-laterPHPPHP ^7.4|^8CI passing Since Mar 18Pushed 3mo ago9 watchersCompare [ Source](https://github.com/ProfessionalWiki/EDTF)[ Packagist](https://packagist.org/packages/professional-wiki/edtf)[ GitHub Sponsors](https://github.com/JeroenDeDauw)[ RSS](/packages/professional-wiki-edtf/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (5)Versions (14)Used By (4) EDTF PHP Library ================ [](#edtf-php-library) [![GitHub Workflow Status](https://camo.githubusercontent.com/a3b7dfb4d35349813da2c4b203f7edb388ec2adabb6bdebc6470df6ccf69065c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f50726f66657373696f6e616c57696b692f454454462f63692e796d6c3f6272616e63683d6d6173746572)](https://github.com/ProfessionalWiki/EDTF/actions?query=workflow%3ACI)[![Type Coverage](https://camo.githubusercontent.com/3130c8af371e98fd9ed47fb158821b7087cbd784ca4d50919c9de4b507472c24/68747470733a2f2f73686570686572642e6465762f6769746875622f50726f66657373696f6e616c57696b692f454454462f636f7665726167652e737667)](https://shepherd.dev/github/ProfessionalWiki/EDTF)[![codecov](https://camo.githubusercontent.com/e2debe56264959276038df6bcc10685fd574fed8152ad0e3252321bd737301bc/68747470733a2f2f636f6465636f762e696f2f67682f50726f66657373696f6e616c57696b692f454454462f6272616e63682f6d61737465722f67726170682f62616467652e7376673f746f6b656e3d476e4f4733464631365a)](https://codecov.io/gh/ProfessionalWiki/EDTF)[![Latest Stable Version](https://camo.githubusercontent.com/1b134385481299f3cc5bc4c55c1b66c0f7bf6cdc5cd4a1808e5afcafeb892ed3/68747470733a2f2f706f7365722e707567782e6f72672f70726f66657373696f6e616c2d77696b692f656474662f762f737461626c65)](https://packagist.org/packages/professional-wiki/edtf)[![Download count](https://camo.githubusercontent.com/7b89948b2ae5a7d215d928eecec9d42624dfd70823bd42be8cadb02d1b8bdc70/68747470733a2f2f706f7365722e707567782e6f72672f70726f66657373696f6e616c2d77696b692f656474662f646f776e6c6f616473)](https://packagist.org/packages/professional-wiki/edtf)[![License](https://camo.githubusercontent.com/50c7c86f147d47ad919bc2d4a5160615fd62ba149f6d63333523d6cd1e6dcdb3/68747470733a2f2f706f7365722e707567782e6f72672f70726f66657373696f6e616c2d77696b692f656474662f6c6963656e7365)](LICENSE) EDTF PHP is a small library for parsing, representing, and working with the [Extended Date/Time Format](https://www.loc.gov/standards/datetime/) specification. [Professional Wiki](https://professional.wiki) created and maintains EDTF. The Luxembourg Ministry of Culture funded the [initial development](https://www.wikibase.consulting/wikibase-edtf/). This library is an open-source project, so contributions are welcome! You can also commission [software development](https://professional.wiki/en/mediawiki-development) via Professional Wiki. - [Usage](#usage) - [Parsing](#parsing) - [Validating](#validating) - [Humanizing](#humanizing) - [Object model](#object-model) - [EDTF support and limits](#edtf-support-and-limits) - [Installation](#installation) - [Development](#development) - [Release notes](#release-notes) Usage ----- [](#usage) ### Parsing [](#parsing) ``` $parser = \EDTF\EdtfFactory::newParser(); $parsingResult = $parser->parse('1985-04-12T23:20:30'); $parsingResult->isValid(); // true $parsingResult->getEdtfValue(); // \EDTF\EdtfValue $parsingResult->getInput(); // '1985-04-12T23:20:30' ``` ### Validating [](#validating) ``` $validator = \EDTF\EdtfFactory::newValidator(); $validator->isValidEdtf('1985-04-12T23:20:30'); // true ``` ### Humanizing [](#humanizing) ``` $humanizer = \EDTF\EdtfFactory::newHumanizerForLanguage( 'en' ); $humanizer->humanize($edtfValue); // string ``` ### Object model [](#object-model) ``` $edtfValue->getMax(); // int $edtfValue->getMin(); // int $edtfValue->covers(\EDTF\EdtfValue $anotherValue); // bool ``` ``` $edtfDate->getYear(); // int $edtfDate->isOpenInterval(); // bool $edtfDate->getQualification(); // \EDTF\Qualification ``` EDTF support and limits ----------------------- [](#edtf-support-and-limits) All level 0, 1 and 2 EDTF formats can be parsed and represented, except for: - Open ranges with a date (Level 2: Qualification): `..2004-06-01/2004-06-20` (This is supported: `../2004-06-20`) Humanization has more limits: - Significant digits (EDTF level 2): `1950S2` (some year between 1900 and 1999, estimated to be 1950) - Group Qualification (EDTF level 2): `2004-06~-11` (year and month approximate) - Qualification of Individual Component (EDTF level 2): `?2004-06-~11` (year uncertain; month known; day approximate) - Level 2 Unspecified Digit: `1XXX-1X` (October, November, or December during the 1000s) Installation ------------ [](#installation) To use the EDTF library in your project, simply add a dependency on professional-wiki/edtf to your project's `composer.json` file. Here is a minimal example of a `composer.json`file that just defines a dependency on EDTF 3.x: ``` { "require": { "professional-wiki/edtf": "~3.0" } } ``` Development ----------- [](#development) Start by installing the project dependencies by executing ``` composer update ``` You can run the tests by executing ``` make test ``` You can run style checks and static analysis by executing ``` make cs ``` To run all CI checks, execute ``` make ``` You can also invoke PHPUnit directly to pass it arguments, as follows ``` vendor/bin/phpunit --filter SomeClassNameOrFilter ``` Release notes ------------- [](#release-notes) ### Version 3.1.0 - 2025-09-23 [](#version-310---2025-09-23) - Added support for installation with a newer version of a used date time library (`nesbot/carbon` 3.x) - Improved translations ### Version 3.0.2 - 2025-05-12 [](#version-302---2025-05-12) - Improved translations ### Version 3.0.1 - 2024-05-03 [](#version-301---2024-05-03) - Fixed "Undefined array key" warning when combining approximation qualifiers - Improved translations ### Version 3.0.0 - 2023-01-18 [](#version-300---2023-01-18) Functional changes: - Improved humanization of uncertain and approximate dates - Improved capitalization in humanization, especially for French - Various translation updates from TranslateWiki, improving humanization for many languages - Added support for pluralization in humanization, for use by TranslateWiki Breaking API changes: - Removed parameter of `ExtDate::uncertain` - Removed parameter of `ExtDate::approximate` - Renamed `FrenchStrategy` to `DefaultStrategy` - Made `Qualification` constructor arguments required Further API changes: - Deprecated `ExtDate::uncertain` in favour of `ExtDate::isUncertain` - Deprecated `ExtDate::approximate` in favour of `ExtDate::isApproximate` - Added `Qualification::newFullyKnown` - Added `Qualification::isFullyKnown` - Added `Qualification::dayIsKnown` - Added `Qualification::monthIsKnown` - Added `Qualification::yearIsKnown` - Added `Qualification::isUncertain`, replacing `Qualification::uncertain` - Added `Qualification::dayIsUncertain` - Added `Qualification::monthIsUncertain` - Added `Qualification::yearIsUncertain` - Added `Qualification::isApproximate`, replacing `Qualification::approximate` - Added `Qualification::dayIsApproximate` - Added `Qualification::monthIsApproximate` - Added `Qualification::yearIsApproximate` - Added `Qualification::isUniform` - Added `Qualification::monthAndYearHaveTheSameQualification` - Added `ExtDate::isUniformlyQualified` ### Version 2.0.2 - 2022-04-29 [](#version-202---2022-04-29) - Improved translations ### Version 2.0.1 - 2022-02-19 [](#version-201---2022-02-19) - `?` is no longer recognized as valid date ### Version 2.0.0 - 2021-04-28 [](#version-200---2021-04-28) - Fixed performance issue for sets with large range elements like `1000-01-01..2000-12-30` - Fixed humanization of sets with more than one element, of which at least one an open range - Improved humanization of sets with range elements like `2000..2010` - Intervals and set ranges with end dates earlier than their start dates are now rejected - Various breaking changes to the `Set` class - Constructor signature changed - Removed `hasOpenStart` and `hasOpenEnd` - Removed `isSingleElement` - Added `Set::isEmpty` - Added `Set::getElements` - Added `SetElement` interface with implementations - `OpenSetElement` - `RangeSetElement` - `SingleDateSetElement` - `ExtDate::precision` and `Season::precision` are now guaranteed to return an integer - `precisionAsString` in `ExtDate` and `Season` is now guaranteed to return a non-empty string ### Version 1.3.0 - 2021-04-26 [](#version-130---2021-04-26) - Fixed season support in intervals - Fixed parsing of open sets with an extra space like `{ ..2021}` (thanks @chaudbak) - Added `ExtDate::iso8601` and `ExtDateTime::iso8601` (thanks @seth-shaw-unlv) - Added `ParsingResult::getErrorMessage` ### Version 1.2.0 - 2021-04-16 [](#version-120---2021-04-16) - Improved humanization of open sets ### Version 1.1.0 - 2021-03-20 [](#version-110---2021-03-20) - Added internationalization to the `StructuredHumanizer` service - Fixed handling of "year 0" ### Version 1.0.0 - 2021-03-19 [](#version-100---2021-03-19) - [Initial release](https://www.wikibase.consulting/wikibase-edtf/) with - Support for EDTF levels 0, 1 and 2 - Parsing - Object model - Internationalized humanization - Validation service - Example data ### Health Score 49 — FairBetter than 95% of packages Maintenance52 Moderate activity, may be stable Popularity44 Moderate usage in the ecosystem Community29 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor1 Top contributor holds 51.8% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~164 days Recently: every ~310 days Total 11 Last Release 238d ago Major Versions 1.3.0 → 2.0.02021-04-28 2.0.2 → 3.0.02023-01-18 ### Community Maintainers ![](https://www.gravatar.com/avatar/451bd4039d530fed8f9c3da91bfa519233a397d2182cdfdcad700f6cfea19b7f?d=identicon)[Jeroen De Dauw](/maintainers/Jeroen%20De%20Dauw) ![](https://avatars.githubusercontent.com/u/1104078?v=4)[Karsten Hoffmeyer](/maintainers/kghbln)[@kghbln](https://github.com/kghbln) --- Top Contributors [![JeroenDeDauw](https://avatars.githubusercontent.com/u/146040?v=4)](https://github.com/JeroenDeDauw "JeroenDeDauw (205 commits)")[![chaudbak](https://avatars.githubusercontent.com/u/59545453?v=4)](https://github.com/chaudbak "chaudbak (81 commits)")[![translatewiki](https://avatars.githubusercontent.com/u/24829418?v=4)](https://github.com/translatewiki "translatewiki (64 commits)")[![kilip](https://avatars.githubusercontent.com/u/301065?v=4)](https://github.com/kilip "kilip (25 commits)")[![mzeinstra](https://avatars.githubusercontent.com/u/5627431?v=4)](https://github.com/mzeinstra "mzeinstra (5 commits)")[![thomas-topway-it](https://avatars.githubusercontent.com/u/46287689?v=4)](https://github.com/thomas-topway-it "thomas-topway-it (5 commits)")[![reedy](https://avatars.githubusercontent.com/u/67615?v=4)](https://github.com/reedy "reedy (3 commits)")[![seth-shaw-unlv](https://avatars.githubusercontent.com/u/29869988?v=4)](https://github.com/seth-shaw-unlv "seth-shaw-unlv (3 commits)")[![DiegoPino](https://avatars.githubusercontent.com/u/6946023?v=4)](https://github.com/DiegoPino "DiegoPino (2 commits)")[![apetushok](https://avatars.githubusercontent.com/u/5189699?v=4)](https://github.com/apetushok "apetushok (1 commits)")[![seth-shaw-asu](https://avatars.githubusercontent.com/u/108362375?v=4)](https://github.com/seth-shaw-asu "seth-shaw-asu (1 commits)")[![malberts](https://avatars.githubusercontent.com/u/1428594?v=4)](https://github.com/malberts "malberts (1 commits)") --- Tags date-timeedtfedtf-phpparserphp ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Psalm Type Coverage Yes ### Embed Badge ![Health badge](/badges/professional-wiki-edtf/health.svg) ``` [![Health](https://phpackages.com/badges/professional-wiki-edtf/health.svg)](https://phpackages.com/packages/professional-wiki-edtf) ``` ### Alternatives [league/commonmark Highly-extensible PHP Markdown parser which fully supports the CommonMark spec and GitHub-Flavored Markdown (GFM) 3.0k404.0M702](/packages/league-commonmark)[spatie/laravel-sitemap Create and generate sitemaps with ease 2.6k14.6M107](/packages/spatie-laravel-sitemap)[sauladam/shipment-tracker Parses tracking information for several carriers, like UPS, USPS, DHL and GLS by simply scraping the data. No need for any kind of API access. 9738.8k](/packages/sauladam-shipment-tracker) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)