Time value objects, parsers and formatters

Clone this repo:



  1. 8093a40 Merge branch 'master' of github.com:DataValues/Time by jeroendedauw · 10 years ago master
  2. 54bfd77 Imrpove PHPUnit bootstrap by jeroendedauw · 10 years ago
  3. 5dd3b90 Update .travis.yml by Jeroen De Dauw · 10 years ago
  4. af1c5c2 Update README.md by Jeroen De Dauw · 10 years ago
  5. 4bb328e Up rel date by jeroendedauw · 10 years ago 0.1

DataValues Time

Library containing value objects to represent temporal information, parsers to turn user input into such value objects, and formatters to turn them back into user consumable representations.

It is part of the DataValues set of libraries.

Build Status Code Coverage Scrutinizer Quality Score

On Packagist: Latest Stable Version Download count


The recommended way to use this library is via Composer.


To add this package as a local, per-project dependency to your project, simply add a dependency on data-values/time to your project's composer.json file. Here is a minimal example of a composer.json file that just defines a dependency on version 1.0 of this package:

    "require": {
        "data-values/time": "1.0.*"


Get the code of this package, either via git, or some other means. Also get all dependencies. You can find a list of the dependencies in the "require" section of the composer.json file. Then take care of autoloading the classes defined in the src directory.


This library comes with a set up PHPUnit tests that cover all non-trivial code. You can run these tests using the PHPUnit configuration file found in the root directory. The tests can also be run via TravisCI, as a TravisCI configuration file is also provided in the root directory.


DataValues Time has been written by the Wikidata team, as [Wikimedia Germany] (https://wikimedia.de) employees for the Wikidata project.

Release notes

0.1 (2013-11-17)

Initial release with these features:

  • TimeValue
  • TimeFormatter
  • TimeIsoFormatter