data-values/time

Time value objects, parsers and formatters

Thursday, February 22, 2018
by addshore
Repository
14 Watchers
10 Stars
119,235 Installations

PHP
15 Dependents
2 Suggesters
5 Forks
7 Open issues
33 Versions
2 % Grown

The README.md

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., _(*1)

It is part of the DataValues set of libraries., _(*2)

, _(*3)

On Packagist: , _(*4)

Installation

The recommended way to use this library is via Composer., _(*5)

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.x of this package:, _(*6)

    {
        "require": {
            "data-values/time": "~1.1"
        }
    }

Manual

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., _(*7)

Tests

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., _(*8)

Authors

DataValues Time has been written by the Wikidata team, as Wikimedia Germany employees for the Wikidata project., _(*9)

Release notes

1.1.2 (2022-10-24)

Allow installation together with data-values/common 1.1.0 and data-values/interfaces 1.x

1.1.1 (2022-10-21)

Allow installation together with DataValues 3.1

1.1.0 (2022-10-21)

Improved compatibility with PHP 8.1; in particular, the new __serialize/__unserialize methods are implemented now (in addition to the still supported Serializable interface). Make sure to also use data-values/data-values version 3.1.0 (or later) to keep hashes stable.
Added support for the YYYY-DDD format (DDDth day of the year) added in PHP 8.1.7. (Not supported in earlier PHP versions.)

1.0.4 (2021-07-15)

Support month+year dates with era

1.0.3 (2021-03-18)

Update major data-values/* versions

1.0.2 (2020-08-20)

Fixed parsing unicode month names

1.0.1 (2018-09-18)

Parse and refuse invalid calendar option

1.0.0 (2018-08-02)

Removed DATAVALUES_TIME_VERSION constant
Allow installation together with DataValues 2.x

0.8.6 (2017-09-06)

Added whitespace trimming to YearTimeParser.
Fixed IsoTimestampParser and TimeValue accepting a time of day with no day.
Fixed MonthNameUnlocalizer accidentally replacing already unlocalized numeric months.
Fixed PhpDateTimeParser misinterpreting inputs with only one or two numbers.
Deprecated TimeValue::newFromArray.
Raised required PHP version from 5.3 to 5.5.

0.8.5 (2017-08-09)

Removed MediaWiki integration
Bump data-values/common dependency

0.8.4 (2016-04-20)

Added MonthNameProvider interface.
Added MonolingualMonthNameProvider.
Added YearMonthTimeParser.
Added YearTimeParser.

0.8.3 (2016-03-16)

Added optional ParserOptions parameter to the YearMonthDayTimeParser constructor.
Fixed YearMonthDayTimeParser not accepting calendar model and precision options.
Fixed IsoTimestampParser not accepting string precisions.
Fixed IsoTimestampParser not always throwing an exception on invalid precisions.
Fixed FORMAT_NAME constants in parsers.

0.8.2 (2015-09-15)

Fixed IsoTimestampParser and TimeValue accepting days with no month.
Fixed YearMonthDayTimeParser rejecting YDM dates.
YearMonthDayTimeParser accepts some more dates where month and day are the same anyway.

0.8.1 (2015-08-14)

Additions

Added YearMonthDayTimeParser.
PhpDateTimeParser now accepts space-separated dates in YMD order.

Other changes

The component can now be installed together with DataValues Interfaces 0.2.x.
The component can now be installed together with DataValues Common 0.3.x.

0.8.0 (2015-06-26)

Breaking changes

IsoTimestampParser auto-detects the calendar model and does not default to Gregorian any more
Removed IsoTimestampParser::PRECISION_NONE, use null instead
TimeValues leap second range changed from [0..62] to [0..61]

Additions

Added EraParser
Added TimeValue::CALENDAR_GREGORIAN and TimeValue::CALENDAR_JULIAN
Renamed all TimeValue::PRECISION_... constants with lower case letters, e.g. PRECISION_10a to PRECISION_YEAR10, leaving backwards compatible aliases
IsoTimestampParser now accepts time values with optional colons, per ISO
PhpDateTimeParser now accepts comma separated dates

Other changes

Fixed IsoTimestampParser not being able to set precision to hour, minute or second on midnight
Deprecated IsoTimestampParser::CALENDAR_GREGORIAN and IsoTimestampParser::CALENDAR_JULIAN
Deprecated TimeFormatter::CALENDAR_GREGORIAN and TimeFormatter::CALENDAR_JULIAN

0.7.0 (2015-04-20)

Breaking changes

Renamed TimeParser to IsoTimestampParser
Empty strings are now detected as invalid calendar models in the TimeValue constructor

Additions

Added MonthNameUnlocalizer
Added PhpDateTimeParser
IsoTimestampParser can now parse various YMD ordered timestamp strings resembling ISO 8601
CalendarModelParser now accepts URIs and localized calendar names given via options

Other changes

The year in TimeValues is now padded to 4 digits, and additional leading zeros are trimmed
Major update of the TimeValue documentation
Constructor arguments in IsoTimestampParser and TimeFormatter are optional now
Fixed TimeFormatter delegating to an ISO timestamp formatter given via option
TimeFormatter does not output the calendar model any more

0.6.1 (2014-10-09)

Made component installable with DataValues 1.x

0.6.0 (2014-06-05)

Added TimeValueCalculator
Removed TimeIsoFormatter interface
Introduced FORMAT_NAME class constants on ValueParsers in order to use them as expectedFormat
Changed ValueParsers to pass rawValue and expectedFormat arguments when constructing a ParseException

0.5.2 (2014-04-28)

Fix parsing of years ending in zero, defaulting precision to year when year is <= 4000 and >= 4000 BC.

0.5.1 (2014-03-24)

Fix composer version of DataValues/Common

0.5.0 (2014-03-21)

Removed TimeParser::SIGN_PATTERN constant
Removed TimeParser::TIME_PATTERN constant
Fixed bug 62730. The TimeParser now returns the correct precision when only month and year or year is given

0.4.0 (2014-03-14)

Corrected spelling errors calender/calander -> calendar

0.3.0 (2014-03-13)

Renamed CalenderModelParser to CalendarModelParser
Added Calandar and Precision options to TimeParser

0.2.0 (2014-02-11)

Added features:, _(*10)

TimeParser
CalenderModelParser

0.1.0 (2013-11-17)

Initial release with these features:, _(*11)

TimeValue
TimeFormatter
TimeIsoFormatter

library time

Time value objects, parsers and formatters

data-values/time

The README.md

DataValues Time

Installation

Composer

Manual

Tests

Authors

Release notes

1.1.2 (2022-10-24)

1.1.1 (2022-10-21)

1.1.0 (2022-10-21)

1.0.4 (2021-07-15)

1.0.3 (2021-03-18)

1.0.2 (2020-08-20)

1.0.1 (2018-09-18)

1.0.0 (2018-08-02)

0.8.6 (2017-09-06)

0.8.5 (2017-08-09)

0.8.4 (2016-04-20)

0.8.3 (2016-03-16)

0.8.2 (2015-09-15)

0.8.1 (2015-08-14)

Additions

Other changes

0.8.0 (2015-06-26)

Breaking changes

Additions

Other changes

0.7.0 (2015-04-20)

Breaking changes

Additions

Other changes

0.6.1 (2014-10-09)

0.6.0 (2014-06-05)

0.5.2 (2014-04-28)

0.5.1 (2014-03-24)

0.5.0 (2014-03-21)

0.4.0 (2014-03-14)

0.3.0 (2014-03-13)

0.2.0 (2014-02-11)

0.1.0 (2013-11-17)

Links

The Versions

dev-master

The Requires

The Development Requires

by The Wikidata team

dev-ymdMonthNames

The Requires

The Development Requires

by The Wikidata team

dev-backwardsCompat

The Requires

The Development Requires

by The Wikidata team

dev-stringChecks

The Requires

The Development Requires

by The Wikidata team

0.8.6

The Requires

The Development Requires

by The Wikidata team

0.8.x-dev

The Requires

by The Wikidata team

0.8.5

The Requires

by The Wikidata team

dev-calendarOption

The Requires

The Development Requires

by The Wikidata team

dev-release085

The Requires

The Development Requires

by The Wikidata team