自述文件

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

它是库的DataValues集.

打开包装商:

安装

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

作曲家

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

{“要求”：{“数据值/数字”：“0.12.*”}}

手动

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

测验

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

作者

DataValues编号由创建德国维基媒体员工这个维基数据项目.

发行说明

0.12.3 (2022-10-24)

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

0.12.2 (2022-10-21)

• 修复数量值和无限数量值哈希值与版本0.11.1相同。

0.12.1 (2022-10-21)

• 允许与数据值/数据值一起使用3.1.0

0.12.0 (2022-10-21)

• 提高与PHP 8.1的兼容性；尤其是新的__序列化/__取消序列化方法现已实现（除了仍然支持可序列化接口）。确保也使用数据值/数据值3.1.0版（或更高版本）以保持哈希稳定。
• 删除数据可用性_编号_版本常数。

0.11.1 (2021-03-31)

• 修复小数数学：：product Without BC对于大于2^63-1（有符号64位整数的最大值）的产品。

0.11.0 (2021-03-15)

• 删除对早于7.2和HHVM的php版本的支持

0.10.2 (2021-03-15)

• 允许与数据值/通用1.0.0一起使用
• 允许与数据值/接口1.0.0一起使用
• 允许与数据值/数据值3.0.0一起使用

0.10.1（2018年10月31日）

• 允许与DataValues 2.x一起安装
• DecimalMath产品现在四舍五入为127个字符以避免致命错误

0.10.0 (2018-04-11)

• 已更改的浮点到字符串转换算法小数点,数量值、和无限数量值。它现在使用PHP的“serialize_precision”默认为17位有效数字。
• 删除与数据值/接口0.1和数据值/公共0.2的兼容性

0.9.1 (2017-08-09)

• 允许与数据值/通用0.4一起使用

0.9.0 (2017-08-09)

• 删除MediaWiki集成
• 去除DecimalParser中的所有空白
• 使用Wikibase的CodeSniffer而不是MediaWiki的

0.8.3（2017-06-26）

• 固定的无边界数量值：：newFromArray不接受混合值。
• 已弃用小数：：newFromArray和无边界数量值：：newFromArray.
• 将所需的最低PHP版本从5.3更新为5.5.9。

0.8.2 (2016-11-17)

• 固定的数量格式设置工具抑制±0数量值第条。
• 修复了中的HTML转义QuantityHtmlFormatter（数量HTML格式设置工具）.

0.8.1 (2016-08-02)

• 无边界数量值：：newFromArray和数量值：：newFromArray双方都接受无不确定性区间和有不确定性区间的序列化。

0.8.0 (2016-08-01)

• 补充小数：：getTrimmed.
• 补充无限数量值.
  • 数量值延伸无限数量值.
  • 数量分析器收益无界数量值而不是总是猜测不确定性间隔。
  • 数量格式设置工具也接受无限数量值第条。
• 数量分析器当要求猜测不确定性区间时，默认为±0.5，而不是±1，例如。1~成为1±0.5.
• 数量格式设置工具当以已知不确定性呈现值时，不再进行四舍五入间隔。
• 中的固定舍入算法小数数学（将1.45四舍五入为2，而不是1）。
• 小数点构造函数可选地接受不带前导加号的字符串。
• 远离的数量值：：getSignificantFigures.
• 远离的数量值：：newFromDecimal（自0.1起已弃用）。
• 这个$vocabularyUriFormatter中的参数数量格式设置工具构造函数不再可以为空。

0.7.0（2016年4月25日）

突破性变化

• 已删除已弃用数量单位格式设置工具接口。
• 已删除已弃用基本数量单位格式设置工具.

其他变更

• 固定的小数点和数量值允许在末尾使用换行符的值。
• 小数点字符串现在被裁剪，允许任何数量的前导和尾随空格。
• 增加了与数据值/公共0.2和0.3的显式兼容性。

0.6.0 (2015-09-09)

突破性变化

• 数量格式设置工具构造函数参数以不兼容的方式更改。
• 基本编号解锁器：：getUnitRegex返回空字符串。A数量分析器使用这个不再接受单位作为输入的一部分。

添加

• 补充QuantityHtmlFormatter（数量HTML格式设置工具）.
• 数量格式设置工具支持连接数字和单位的可选格式字符串。

其他变更

• 已弃用数量单位格式设置工具接口。
• 已弃用基本数量单位格式设置工具.
• 数量分析器现在总是修剪它通过选项获得的单元。
• 该组件现在可以与DataValues Interfaces 0.2.x一起安装。

0.5.0 (2015-06-11)

突破性变化

• 数量格式设置工具构造函数参数以不兼容的方式更改

添加

• 补充数量单位格式设置工具接口
• 补充基本数量单位格式设置工具
• 补充数量格式设置工具：：OPT_APPLY_UNIT选项
• 补充数量分析器：：OPT_UNIT选项
• 补充小数分析器：：applyDecimalExponent
• 补充DecimalParser:：splitDecimalExponent

其他变更

• 数量分析器现在可以正确检测科学记数法的精度
• 在中使构造函数参数可选小数格式设置工具和数量格式设置工具
• 将DataValues接口依赖项更新为0.1.5

0.4.1（2014-10-09）

• 该组件现在可以与DataValues 1.x一起安装

0.4 (2014-04-24)

• Unlocalizer接口重命名为NumberUnlocalize
• 本地化程序接口重命名为NumberLocalizer
• BasicUnlocalizer接口重命名为BasicNumberUnlocalize
• BasicLocalizer接口重命名为BasicNumberLocalizer
• 在ValueParsers上引入FORMAT_NAME类常量，以便将它们用作预期格式
• 更改ValueParsers以在构造时传递rawValue和expectedFormat分析异常

0.3 (2014-03-12)

• Unlocalizer：添加了getNumberRegex（）和getUnitRegx（）
• Unlocalizer：将unlocalize（）替换为unlocalizeNumber（）
• 本地化程序：将localize（）替换为localizeNumber（）
• Localizer和Unlocalizer：不再需要目标语言和方法调用中的选项
• QuantityParser：固定解析国际化数量字符串

0.2 (2013-12-16)

删除

• IntParser已移至data-values/common
• FloatParser已移至data-values/common

添加

• 小数：：min
• 小数：：max
• 小数：：shift
• 添加了选项以强制在DecimalFormatter中显示符号

改进

• QuantityParser和DecimalParser现在支持科学记数法
• DecimalParser现在支持本地化的值解析
• DecimalFormatter现在支持值的本地化

错误修复

• 处理十进制值时发生的浮点错误已得到修复。(错误56682)

0.1 (2013-11-17)

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

• 小数数学
• 小数点
• 数量值
• 小数格式设置工具
• 数量格式设置工具
• 小数分析器
• 浮点分析器
• 内部分析器
• 数量分析器

链接

• Packagist上的DataValues编号
• TravisCI上的DataValues编号