PHP 8.5.0 Beta 2 available for testing

NumberFormatter::format

numfmt_format

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

NumberFormatter::format -- numfmt_formatФорматирует число

Описание

Объектно-ориентированный стиль

public NumberFormatter::format(int|float $num, int $type = NumberFormatter::TYPE_DEFAULT): string|false

Процедурный стиль

numfmt_format(NumberFormatter $formatter, int|float $num, int $type = NumberFormatter::TYPE_DEFAULT): string|false

Функция форматирует числовое значение по правилами средства форматирования.

Список параметров

formatter

Объект NumberFormatter.

num

Значение для форматирования. Параметр принимает значения int, float и другие типы, которые преобразовываются в числовое значение.

type

Тип форматирования. Параметр не поддерживает константу NumberFormatter::TYPE_CURRENCY; вместо вызова с этим флагом значение валюты форматируют методом NumberFormatter::formatCurrency().

Возвращаемые значения

Функция возвращает строку, которая содержит отформатированное значение, или false, если возникла ошибка.

Примеры

Пример #1 Пример форматирования числа функцией numfmt_format()

<?php

$fmt
= numfmt_create('de_DE', NumberFormatter::DECIMAL);
$data = numfmt_format($fmt, 1234567.891234567890000);
var_dump($data);

?>

Пример #2 Пример форматирования числа в объектно-ориентированном стиле

<?php

$fmt
= new NumberFormatter( 'de_DE', NumberFormatter::DECIMAL );
$data = $fmt->format(1234567.891234567890000);
var_dump($data);

?>

Результат выполнения приведённого примера:

string(13) "1.234.567,891"

Примечания

Замечание:

Этот метод форматирования поддерживает функции базовой библиотеки ICU не на 100 % и, например, не разрешает выбирать формат обозначения валюты: р. или ₽.

Полную поддержку функций библиотеки даёт функция msgfmt_format_message().

Смотрите также

Добавить

Примечания пользователей 1 note

up
1
mrSplendid
2 years ago
on Linux you may need to install icu-data-full package for NumberFormatter to work properly with non-english locales.
To Top