Files
php-doc-ru/reference/intl/numberformatter.xml
2021-12-25 03:22:29 +03:00

127 lines
5.4 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a6591916b7cfe4072e7d9f6a3cec3e4b4b22f845 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<phpdoc:classref xml:id="class.numberformatter" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The NumberFormatter class</title>
<titleabbrev>NumberFormatter</titleabbrev>
<partintro>
<!-- {{{ NumberFormatter intro -->
<section xml:id="numberformatter.intro">
&reftitle.intro;
<simpara>
Программы хранят и оперируют числами используя, не зависящее от локали,
бинарное представление. Когда же они выводятся на экран или печатаются,
они конвертируются в строки в соответствии с требованиями локали.
К примеру, число 12345.67 выведется как "12,345.67" в локали US,
как "12 345,67" во французской локали и как "12.345,67" в немецкой.
</simpara>
<simpara>
Вызывая методы этого класса, вы можете форматировать числа, денежные единицы
и процентные величины в представлении нужной локали. Класс NumberFormatter
чувствителен к локали, следовательно вам необходимо будет создавать новый
экземпляр класса для каждой локали. Методы NumberFormatter форматируют примитивные
типы чисел, такие как "double", и выводят их в специфичном для локали представлении.
</simpara>
<para>
Для денежных единиц вы можете использовать тип форматирования денежных единиц,
который возвращает строку с отформатированным числом и символом денежной единицы.
Естественно NumberFormatter не знает о курсах обмена, так что для всех денежных единиц
будет возвращено одно и то же число.
К примеру, для числа 9988776.65 результат будет такой:
<simplelist>
<member>9 988 776,65 € для Франции</member>
<member>9.988.776,65 € для Германии</member>
<member>$9,988,776.65 для США</member>
</simplelist>
</para>
<simpara>
Для форматирования процентных величин используется свой тип форматирования.
При таком форматировании число 0.75 будет выведено как 75%.
</simpara>
<simpara>
Для более сложного форматирования, например для разбора числа,
используется форматирование основанное на наборе правил.
</simpara>
</section>
<!-- }}} -->
<section xml:id="numberformatter.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass>
<classname>NumberFormatter</classname>
</ooclass>
<classsynopsisinfo>
<ooclass>
<classname>NumberFormatter</classname>
</ooclass>
</classsynopsisinfo>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.numberformatter')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.numberformatter')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
</section>
&reference.intl.numberformatter-constants;
<section xml:id="numberformatter.seealso">
&reftitle.seealso;
<para>
<simplelist>
<member>
<link xlink:href="&url.icu.formatparse;">
ICU formatting documentation
</link>
</member>
<member>
<link xlink:href="&url.icu.formatnumbers;">ICU. Форматирование чисел</link>
</member>
<member>
<link xlink:href="&url.icu.decimalformat;">ICU. Форматирование десятичных дробей</link>
</member>
<member>
<link xlink:href="&url.icu.ruleformat;">
ICU. Форматирование на основе правил
</link>
</member>
</simplelist>
</para>
</section>
</partintro>
&reference.intl.entities.numberformatter;
</phpdoc:classref>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->