类编号

数字帮助程序库。

使数字更易读的方法。

命名空间： Cake\I18n
链接： https://book.cakephp.com.cn/5/en/core-libraries/number.html

常量

字符串

DEFAULT_LOCALE ¶
```
'en_US'
```
默认语言环境
字符串

FORMAT_CURRENCY ¶
```
'currency'
```
格式类型，用于格式化为货币
字符串

FORMAT_CURRENCY_ACCOUNTING ¶
```
'currency_accounting'
```
格式类型，用于格式化为货币，会计风格（负数用括号括起来）

属性摘要

$_defaultCurrency protected static

字符串 | 空

Number::currency() 使用的默认货币
$_defaultCurrencyFormat protected static

字符串 | 空

Number::currency() 使用的默认货币格式
$_formatters protected static

数组<字符串, 数组<整数, 混合>>

按语言环境和类型索引的数字格式器列表

方法摘要

_setAttributes() protected static

设置格式器属性
config() public static

配置格式器。
currency() public static

将数字格式化为货币格式。
format() public static

将数字格式化为正确的语言环境格式
formatDelta() public static

将数字格式化为正确的语言环境格式以显示增量（值的有符号差异）。
formatter() public static

返回一个格式器对象，该对象可在相同语言环境和选项下重复使用以执行类似的格式化任务。这通常是使用此类中其他方法的更快替代方案，因为只需要构造一个格式器对象。
getDefaultCurrency() public static

默认货币的 getter
getDefaultCurrencyFormat() public static

默认货币格式的 getter
ordinal() public static

将格式化的整数作为序数字符串返回（例如，第一、第二、第三、第四、[...]）
parseFloat() public static

解析本地化的数字字符串并将其转换为浮点数
precision() public static

以一定精度格式化数字。
setDefaultCurrency() public static

默认货币的 setter
setDefaultCurrencyFormat() public static

默认货币格式的 setter
toPercentage() public static

将数字格式化为百分比字符串。
toReadableSize() public static

返回一个格式化为人类可读的文件大小。

方法详情

_setAttributes() ¶ protected static

_setAttributes(NumberFormatter $formatter, array<string, mixed> $options = []): NumberFormatter

设置格式器属性

参数

NumberFormatter $formatter: 数字格式器实例。
数组<字符串, 混合> $options 可选: 有关可能的选项，请参见 Number::formatter()。

NumberFormatter

config() ¶ public static

config(string $locale, int $type = NumberFormatter::DECIMAL, array<string, mixed> $options = []): void

配置格式器。

参数

字符串 $locale: 用于格式化数字的语言环境名称，例如 fr_FR
整数 $type 可选: 要构建的格式器类型。默认为 NumberFormatter::DECIMAL。
数组<字符串, 混合> $options 可选: 有关可能的选项，请参见 Number::formatter()。

void

currency() ¶ public static

currency(string|float|int $value, string|null $currency = null, array<string, mixed> $options = []): string

将数字格式化为货币格式。

选项

语言环境 - 用于格式化数字的语言环境名称，例如 fr_FR
fractionSymbol - 用于小数的货币符号。
fractionPosition - 小数符号应放置的位置，有效选项为“before”和“after”。
before - 在渲染的数字之前显示的文本
after - 在渲染的数字之后显示的文本
zero - 用于零值的文本，可以是字符串或数字。例如 0、'免费！'
places - 要使用的十进制位数。例如 2
precision - 要使用的最大十进制位数，例如 2
roundingMode - 要使用的舍入模式。例如 NumberFormatter::ROUND_HALF_UP。如果未设置，将使用语言环境默认值
pattern - 用于格式化数字的 ICU 数字模式。例如 #,##0.00
useIntlCode - 是否用国际货币代码替换货币符号。

参数

字符串 | 浮点数 | 整数 $value: 要格式化的值。
字符串 | 空 $currency 可选: 国际货币名称，例如“USD”、“EUR”、“JPY”、“CAD”
数组<字符串, 混合> $options 可选: 选项列表。

字符串

format() ¶ public static

format(string|float|int $value, array<string, mixed> $options = []): string

将数字格式化为正确的语言环境格式

选项

places - 要使用的最小小数位数，例如 0
precision - 要使用的最大十进制位数，例如 2
pattern - 用于格式化数字的 ICU 数字模式。例如 #,##0.00
语言环境 - 用于格式化数字的语言环境名称，例如 fr_FR
before - 要放置在整数之前的字符串，例如 '['
after - 要放置在小数之后的字符串，例如 ']'

参数

字符串 | 浮点数 | 整数 $value: 一个浮点数。
数组<字符串, 混合> $options 可选: 包含选项的数组。

字符串

formatDelta() ¶ public static

formatDelta(string|float|int $value, array<string, mixed> $options = []): string

将数字格式化为正确的语言环境格式以显示增量（值的有符号差异）。

选项

places - 要使用的最小小数位数，例如 0
precision - 要使用的最大十进制位数，例如 2
语言环境 - 用于格式化数字的语言环境名称，例如 fr_FR
before - 要放置在整数之前的字符串，例如 '['
after - 要放置在小数之后的字符串，例如 ']'

参数

字符串 | 浮点数 | 整数 $value: 一个浮点数
数组<字符串, 混合> $options 可选: 选项列表。

字符串

formatter() ¶ public static

formatter(array<string, mixed> $options = []): NumberFormatter

返回一个格式器对象，该对象可在相同语言环境和选项下重复使用以执行类似的格式化任务。这通常是使用此类中其他方法的更快替代方案，因为只需要构造一个格式器对象。

选项

语言环境 - 用于格式化数字的语言环境名称，例如 fr_FR
type - 要构建的格式器类型，如果您需要格式化表示货币的数字或 NumberFormatter 常量，请将其设置为“currency”。
places - 要使用的十进制位数。例如 2
precision - 要使用的最大十进制位数，例如 2
roundingMode - 要使用的舍入模式。例如 NumberFormatter::ROUND_HALF_UP。如果未设置，将使用语言环境默认值
pattern - 用于格式化数字的 ICU 数字模式。例如 #,##0.00
useIntlCode - 是否用国际货币代码替换货币符号。

参数

数组<字符串, 混合> $options 可选: 包含选项的数组。

NumberFormatter

getDefaultCurrency() ¶ public static

getDefaultCurrency(): string

默认货币的 getter

字符串

getDefaultCurrencyFormat() ¶ public static

getDefaultCurrencyFormat(): string

默认货币格式的 getter

字符串

ordinal() ¶ public static

ordinal(float|int $value, array<string, mixed> $options = []): string

将格式化的整数作为序数字符串返回（例如，第一、第二、第三、第四、[...]）

选项

type - 要构建的格式器类型，如果您需要格式化表示货币的数字或 NumberFormatter 常量，请将其设置为“currency”。

有关所有其他选项，请参见 formatter()。

参数

浮点数 | 整数 $value: 一个整数
数组<字符串, 混合> $options 可选: 包含选项的数组。

字符串

parseFloat() ¶ public static

parseFloat(string $value, array<string, mixed> $options = []): float

解析本地化的数字字符串并将其转换为浮点数

选项

locale - 用于解析数字的区域设置名称，例如 fr_FR
type - 要构造的格式化程序类型，如果需要解析代表货币的数字，请将其设置为 currency。

参数

string $value: 一个数字字符串。
数组<字符串, 混合> $options 可选: 包含选项的数组。

float

precision() ¶ public static

precision(string|float|int $value, int $precision = 3, array<string, mixed> $options = []): string

以一定精度格式化数字。

选项

locale: 用于格式化数字的区域设置名称，例如 fr_FR

参数

字符串 | 浮点数 | 整数 $value: 一个浮点数。
int $precision optional: 返回数字的精度。
数组<字符串, 混合> $options 可选: 其他选项

字符串

链接

https://book.cakephp.com.cn/5/en/core-libraries/number.html#formatting-floating-point-numbers

setDefaultCurrency() ¶ public static

setDefaultCurrency(string|null $currency = null): void

默认货币的 setter

参数

字符串 | 空 $currency 可选: 在 {@link currency()} 中使用，如果未提供 $currency 参数，则使用默认货币字符串。如果传递 null，它将清除当前存储的值

void

setDefaultCurrencyFormat() ¶ public static

setDefaultCurrencyFormat(string|null $currencyFormat = null): void

默认货币格式的 setter

参数

string|null $currencyFormat optional: 在 currency() 中使用，如果未提供 $currencyFormat 参数，则使用默认货币格式。如果传递 null，它将清除当前存储的值

void

toPercentage() ¶ public static

toPercentage(string|float|int $value, int $precision = 2, array<string, mixed> $options = []): string

将数字格式化为百分比字符串。

选项

multiply: 将输入值乘以 100 以获得小数百分比。
locale: 用于格式化数字的区域设置名称，例如 fr_FR

参数

字符串 | 浮点数 | 整数 $value: 一个浮点数
int $precision optional: 返回数字的精度
数组<字符串, 混合> $options 可选: 选项

字符串

链接

https://book.cakephp.com.cn/5/en/core-libraries/number.html#formatting-percentages

toReadableSize() ¶ public static

toReadableSize(string|float|int $size): string

返回一个格式化为人类可读的文件大小。

参数

string|float|int $size: 以字节为单位的大小

字符串

链接

https://book.cakephp.com.cn/5/en/core-libraries/number.html#interacting-with-human-readable-values

属性详细信息

`$_defaultCurrency` ¶ protected static

Number::currency() 使用的默认货币

类型

字符串 | 空

`$_defaultCurrencyFormat` ¶ protected static

Number::currency() 使用的默认货币格式

类型

字符串 | 空

`$_formatters` ¶ protected static

按语言环境和类型索引的数字格式器列表

类型

数组<字符串, 数组<整数, 混合>>

命名空间

类编号

常量

属性摘要

方法摘要

_setAttributes() protected static

config() public static

currency() public static

format() public static

formatDelta() public static

formatter() public static

getDefaultCurrency() public static

getDefaultCurrencyFormat() public static

ordinal() public static

parseFloat() public static

precision() public static

setDefaultCurrency() public static

setDefaultCurrencyFormat() public static

toPercentage() public static

toReadableSize() public static

方法详情

_setAttributes() ¶ protected static

参数

返回

config() ¶ public static

参数

返回

currency() ¶ public static

选项

参数

返回

format() ¶ public static

参数

返回

formatDelta() ¶ public static

选项

参数

返回

formatter() ¶ public static

选项

参数

返回

getDefaultCurrency() ¶ public static

返回

getDefaultCurrencyFormat() ¶ public static

返回

ordinal() ¶ public static

选项

参数

返回

parseFloat() ¶ public static

参数

返回

precision() ¶ public static

参数

返回

链接

setDefaultCurrency() ¶ public static

参数

返回

setDefaultCurrencyFormat() ¶ public static

参数

返回

toPercentage() ¶ public static

参数

返回

链接

toReadableSize() ¶ public static

参数

返回

链接

属性详细信息

$_defaultCurrency ¶ protected static

类型

$_defaultCurrencyFormat ¶ protected static

类型

$_formatters ¶ protected static

类型

`$_defaultCurrency` ¶ protected static

`$_defaultCurrencyFormat` ¶ protected static

`$_formatters` ¶ protected static