Алексей Валиков - Технология XSLT

[NF 14] NFPercent ::= '%'

Синтаксические правила, которые мы привели выше, пока не являются стандартными. Они корректно передают синтаксис образца форматирования, но являются более строгими, чем определения в документации языка Java.

Синтаксис элемента задан конструкцией вида:

name=" имя "

decimal-separator=" символ "

grouping-separator=" символ "

infinity=" строка "

minus-sign=" символ "

NaN=" строка "

percent=" символ "

per-mille=" символ "

zero-digit=" символ "

digit=" символ "

pattern-sераrator=" символ "/>

XSLT позволяет изменять специальные символы, влияющие на форматирование строки. Именованный набор таких символов и некоторых других указаний называется десятичным форматом и определяется элементом xsl:decimal-format. От атрибутов этого элемента зависит, как будут обрабатываться символы образца форматирования и как число будет отображаться на выходе:

Атрибут nameэлемента xsl:decimal-formatзадает расширенное имя десятичного формата. Если имя не указано, это означает, что элемент xsl:decimal-formatопределяет десятичный формат по умолчанию.

Остальные атрибуты контролируют интерпретацию форматирующего образца и вывод строкового представления числа следующим образом:

□ decimal-separator— задает символ, разделяющий целую и дробную части числа. Значением этого атрибута по умолчанию является символ " .", с Unicode-кодом #x2e. Атрибут decimal-separatorрассматривается как специальный символ образца форматирования. Кроме того, он будет использован как разделяющий символ при выводе;

□ grouping-separator— задает символ, группирующий цифры в целой части записи числа. Такие символы используются, например, для группировки тысяч (" 1,234,567.89"). Значением по умолчанию является символ " ,", код #x2c. grouping-separatorрассматривается как специальный символ образца форматирования. Помимо этого, он будет использован как разделяющий символ групп цифр при выводе числа;

□ percent— задает символ процента. Значением по умолчанию является символ " %", код #x25. Этот символ будет распознаваться в образце форматирования и использоваться при выводе;

□ per-mille— задает символ промилле. Значением по умолчанию является символ " ‰", код #х2030. Символ промилле распознается в образце форматирования и используется в строковом представлении числа;

□ zero-digit— задает символ нуля. Значением по умолчанию является символ " 0", код #x30;. В качестве цифр при отображении числа будут использоваться символ нуля и 9 символов, следующих за ним. Символ нуля распознается в образце форматирования и используется при выводе строкового представления числа;

□ digit— определяет символ, который используется в образце форматирования для определения позиции необязательного символа. Значением по умолчанию является символ " #". Этот символ распознается как форматирующий символ необязательной цифры. Он не включается в строковое представление числа;

□ pattern-separator— определяет символ, который используется в образце форматирования для разделения положительного и отрицательного форматов числа. Он не включается в строковое представление числа. Значением этого атрибута по умолчанию является символ " ;";

□ infinity— задает строку, которая будет представлять бесконечность. Значением по умолчанию является строка " Infinity";

□ NaN— задает строку, которая будет представлять не-числа. Значением по умолчанию является строка " NaN";

□ minus-sign— задает символ, который будет использоваться для обозначения отрицательных чисел. Значением по умолчанию является символ " -", код #x2D.

Элемент xsl:decimal-formatне имеет смысла без функции format-number. Все, на что влияют его атрибуты — это формат, который будет использоваться при преобразовании чисел в строку функцией format-number.

Определение десятичного формата:

name="format1"

decimal-separator=","

minus-sign="N"

grouping-separator=":"

infinity="∞"

NaN="not-a-number"

percent="%"

digit="$"

pattern-separator="|"/>

Примеры функций format-number:

format-number(123456.78, '$,0000', 'format1)→ '123456,7800'

format-number(-123456.78, '$,00$$', 'format1')→ 'N123456,78'