International PHP Conference Berlin 2025

NumberFormatter::setPattern

numfmt_set_pattern

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

NumberFormatter::setPattern -- numfmt_set_patternУстанавливает шаблон средства форматирования

Описание

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

public NumberFormatter::setPattern(string $pattern): bool

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

numfmt_set_pattern(NumberFormatter $formatter, string $pattern): bool

Устанавливает шаблон, используемый средством форматирования. Не может использоваться в средстве форматирования на основе правил.

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

formatter

Объект NumberFormatter.

pattern

Шаблон в синтаксисе, описанном в » документации ICU DecimalFormat.

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

Функция возвращает true в случае успешного выполнения или false, если возникла ошибка.

Примеры

Пример #1 Пример использования numfmt_set_pattern()

<?php
$fmt
= numfmt_create( 'de_DE', NumberFormatter::DECIMAL );
echo
"Шаблон: ".numfmt_get_pattern($fmt)."\n";
echo
numfmt_format($fmt, 1234567.891234567890000)."\n";
numfmt_set_pattern($fmt, "#0.# kg");
echo
"Шаблон: ".numfmt_get_pattern($fmt)."\n";
echo
numfmt_format($fmt, 1234567.891234567890000)."\n";
?>

Пример #2 Пример использования в объектно-ориентированном стиле

<?php
$fmt
= new NumberFormatter( 'de_DE', NumberFormatter::DECIMAL );
echo
"Шаблон: ".$fmt->getPattern()."\n";
echo
$fmt->format(1234567.891234567890000)."\n";
$fmt->setPattern("#0.# kg");
echo
"Шаблон: ".$fmt->getPattern()."\n";
echo
$fmt->format(1234567.891234567890000)."\n";
?>

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

Шаблон: #,##0.###
1.234.567,891
Шаблон: #0.# kg
1234567,9 kg

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

  • numfmt_get_error_code() - Получает последний код ошибки средства форматирования
  • numfmt_create() - Создаёт средство форматирования чисел
  • numfmt_get_pattern() - Получает шаблон средства форматирования

Добавить

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

up
18
Crash
4 years ago
If you're looking for the pattern syntax, their documentation is here: http://unicode.org/reports/tr35/tr35-numbers.html#Number_Format_Patterns
up
0
Anonymous
5 years ago
setPattern appears to influence only the behavior of the format method, not the parse method of the NumberFormatter object.

$pattern = '#,##0';
$frmtr = NumberFormatter::create('en-US', NumberFormatter::DECIMAL);
$frmtr->setPattern($pattern);
echo $frmtr->parse('12.345');

// returns 12
To Top