自述文件

包含表示时间信息的值对象、转换用户输入的解析器的库转换为此类值对象，并使用格式化程序将其转换回用户可使用的表示形式。

它是库的DataValues集.

打开包装商:

安装

建议使用此库的方法是通过作曲家.

作曲家

要将此包作为本地、项目间的依赖项添加到项目中，只需添加一个依赖于数据值/时间到您的项目作曲家.json文件。下面是一个最小的示例作曲家.json仅定义依赖项的文件此软件包的1.x版本：

    {
        “需要”:{
            “数据值/时间”:"~1.1"
        }
    }

手动

通过git或其他方式获取此包的代码。还要获取所有依赖项。您可以在composer.json文件的“require”部分找到依赖项列表。然后注意自动加载src目录中定义的类。

测试

这个库附带了一个涵盖所有非普通代码的PHPUnit测试设置。你可以运行这些使用根目录中的PHPUnit配置文件进行测试。也可以运行测试通过TravisCI，因为TravisCI配置文件也在根目录中提供。

作者

数据值时间由Wikidata团队编写德国维基媒体员工Wikidata项目.

发行说明

1.1.2 (2022-10-24)

• 允许与数据值/通用1.1.0和数据值/接口1.x一起安装

1.1.1（2022-10-21）

• 允许与DataValues 3.1一起安装

1.1.0 (2022-10-21)

• 改进了与PHP 8.1的兼容性；尤其是新的__序列化/__取消序列化方法现已实现（除了仍然支持可序列化接口）。确保也使用数据值/数据值3.1.0版（或更高版本）以保持哈希稳定。
• 在PHP 8.1.7中添加了对YYYY-DD格式（一年中的第几天）的支持。（早期PHP版本不支持。）

1.0.4 (2021-07-15)

• 支持带纪元的月份+年份日期

1.0.3 (2021-03-18)

• 更新专业数据值/*版本

1.0.2 (2020-08-20)

• 修复了分析unicode月份名称的问题

1.0.1 (2018-09-18)

• 分析并拒绝无效的日历选项

1.0.0 (2018-08-02)

• 远离的数据可用时间版本常数
• 允许与DataValues 2.x一起安装

0.8.6 (2017-09-06)

• 已将空白修整添加到年时间分析器.
• 固定的等时戳分析器和时间值接受一天中没有一天的时间。
• 固定的月份名称取消本地化意外地替换了已取消缩放的数字月份。
• 固定的PhpDateTimeParser（PhpDate时间分析器）误读只有一个或两个数字的输入。
• 已弃用时间值：：newFromArray.
• 将所需的PHP版本从5.3提高到5.5。

0.8.5 (2017-08-09)

• 删除了MediaWiki集成
• 凹凸数据值/公共依赖性

0.8.4（2016年4月20日）

• 补充月份名称提供商接口。
• 补充单语MonthName提供者.
• 补充年月份时间分析器.
• 补充年时间分析器.

0.8.3 (2016-03-16)

• 添加了可选分析器选项参数到年月日时间分析器构造函数。
• 固定的年月日时间分析器不接受日历模型和精度选项。
• 固定的等时戳分析器不接受字符串精度。
• 固定的等时戳分析器不总是对无效精度抛出异常。
• 固定的格式_名称解析程序中的常量。

0.8.2 (2015-09-15)

• 固定的等时戳分析器和时间值接受没有月份的天数。
• 固定的年月日时间分析器拒绝YDM日期。
• 年月日时间分析器接受月份和日期相同的更多日期。

0.8.1 (2015-08-14)

添加

• 补充年月日时间分析器.
• PhpDateTimeParser（PhpDate时间分析器）现在接受YMD顺序的空格分隔日期。

其他变更

• 该组件现在可以与DataValues Interfaces 0.2.x一起安装。
• 该组件现在可以与DataValues Common 0.3.x一起安装。

0.8.0 (2015-06-26)

突破性变化

• IsoTimestamp分析器自动检测日历模型，不再默认为Gregorian
• 远离的IsoTimestampParser:：PRECISION_NONE，使用无效的相反
• 时间值s闰秒范围从[0.62]更改为[0.61]

添加

• 补充EraParser公司
• 补充时间值：：CALENDAR_GREGORIAN和时间值：：日历_JULIAN
• 已全部重命名时间值：：PRECISION_。。。带有小写字母的常量，例如。精度_10a到精度_年份10，保留向后兼容的别名
• 等时戳分析器现在根据ISO接受带有可选冒号的时间值
• PhpDateTimeParser（PhpDate时间分析器）现在接受逗号分隔的日期

其他变更

• 固定的等时戳分析器无法在午夜将精度设置为小时、分钟或秒
• 已弃用IsoTimestampParser:：日历_GREGORIAN和IsoTimestampParser:：日历_朱利安
• 已弃用时间格式设置工具：：CALENDAR_GREGORIAN和时间格式设置工具：：CALENDAR_JULIAN

0.7.0 (2015-04-20)

突破性变化

• 已重命名时间分析器到等时戳分析器
• 空字符串现在被检测为无效的日历模型时间值建造师

添加

• 补充月份名称取消本地化
• 补充PhpDateTimeParser（PhpDate时间分析器）
• 等时戳分析器现在可以解析各种类似ISO 8601的YMD有序时间戳字符串
• 日历模型分析程序现在接受通过选项提供的URI和本地化日历名称

其他变更

• 年时间值s现在被填充到4位，并且额外的前导零被修剪
• 的主要更新时间值文档
• 中的构造函数参数IsoTimestamp分析器和时间格式设置工具现在是可选的
• 固定的时间格式设置工具通过选项委托给给定的ISO时间戳格式化程序
• 时间格式设置工具不再输出日历模型

0.6.1 (2014-10-09)

• 使组件可使用DataValues 1.x安装

0.6.0 (2014-06-05)

• 添加了TimeValueCalculator
• 已删除TimeIsoFormatter接口
• 在ValueParsers上引入FORMAT_NAME类常量，以便将其用作预期格式
• 更改ValueParsers以在构造ParseException时传递rawValue和expectedFormat参数

0.5.2 (2014-04-28)

• 修复对以零结尾的年份的解析，当公元前4000年和4000年。

0.5.1（2014-03-24）

• 修复DataValues/Common的编写器版本

0.5.0 (2014-03-21)

• 已删除TimeParser:：SIGN_PATTERN常量
• 删除了TimeParser:：TIME_PATTERN常量
• 固定的错误62730。TimeParser现在只返回月份和年份或年份时的正确精度

0.4.0 (2014-03-14)

• 更正拼写错误calender/calander->calendar

0.3.0 (2014-03-13)

• 将CalenderModelParser重命名为CalendarModelParser
• 向TimeParser添加了Calandar和Precision选项

0.2.0 (2014-02-11)

新增功能：

• 时间分析器
• 日历模型分析器

0.1.0 (2013-11-17)

具有以下功能的初始版本：

• 时间值
• 时间格式设置工具
• 时间IsoFormatter

链接

• Packagist上的DataValues时间
• TravisCI上的DataValues时间