PHP money_format()Функции

PHP String 参考手册Справочное руководство по строкам PHP

Примеры

Международный формат en_US:

<?php
$number = 1234.56;
setlocale(LC_MONETARY,"en_US");
echo money_format("The price is %i", $number);
?>

Приведённый выше код выведет:

Цена — USD 1,234.56

Определение и использование

Функция money_format() возвращает строку, отформатированную как денежная строка.

Эта функция вставляет отформатированное число в основную строку в позиции знака процента (%).

Примечание:Функция money_format() не работает на платформах Windows.

Совет:Эта функция часто используется сsetlocale()функцией.

Совет:Чтобы просмотреть все доступные языковые коды, посетите наш Справочник по языковым кодам。

Синтаксис

money_format(string,number)

Параметр Описание
string Обязательный. Задает строку для форматирования и способ форматирования переменных в строке.

Возможные значения формата:

Заполнение и флаги:

  • =f- Указывает символ (f), который будет использоваться для заполнения (например, %=t использует "t" в качестве заполнения). По умолчанию для заполнения используются пробелы.
  • ^ - Убирает использование символов группировки.
  • + или ( - Указывает, как отображаются положительные и отрицательные числа. Если используется "+", используются знаки + и - из локали (обычно знак перед отрицательными числами, без знака перед положительными числами). Если используется "(", отрицательные числа заключаются в скобки. По умолчанию — "+".
  • ! - Отключает использование символа валюты в выходной строке.
  • - Если используется "-", все поля выравниваются по левому краю. По умолчанию они выравниваются по правому краю.

Ширина поля:

  • x- Задает минимальную ширину поля (x). По умолчанию — 0.
  • #x- Задает максимальное количество цифр слева от десятичной точки (x). Используется для выравнивания форматированного вывода в одном столбце. Если количество цифр больше x, этот параметр игнорируется.
  • .x- Задает максимальное количество цифр справа от десятичной точки (x). Если x равно 0, десятичная точка и цифры справа от нее не отображаются. По умолчанию используется настройка локали.

Символы преобразования:

  • i — число форматируется в формате международной валюты.
  • n — число форматируется в формате национальной валюты.
  • % — возвращает символ %.

Примечание:Если используется несколько вышеуказанных значений формата, они должны использоваться в указанном выше порядке и не могут быть переупорядочены.

Примечание:На эту функцию влияют настройки локали.
число Обязательный. Число, которое вставляется в позицию знака % в форматированной строке.

Технические детали

Возвращаемое значение: Возвращает отформатированную строку. Символы до и после отформатированной строки возвращаются без изменений. Нечисловые значения возвращают NULL и вызывают E_WARNING.
Версия PHP: 4.3.0+

Другие примеры

Пример 1

Международный формат с 2 десятичными знаками (Германия):

<?php
$number = 1234.56;
setlocale(LC_MONETARY,"de_DE");
echo money_format("%.2n", $number);
?>

Приведённый выше код выведет:

1 234,56 EUR


Пример 2

Отрицательное число, международный формат США с () для обозначения отрицательных чисел, точность 2 справа, "*" в качестве символа-заполнителя:

<?php
$number = -1234.5672;
echo money_format("%=*(#10.2n",$number);
?>

Приведённый выше код выведет:

(******1234.57)


PHP String 参考手册Справочное руководство по строкам PHP Другие расширения