DecimalPipe — Angular

Форматирует значение в соответствии с параметрами цифр и правилами локали. Локаль определяет размер групп и разделитель, символ десятичной точки и другие настройки, зависящие от локали.

Использование канала

{{ value_expression | number:digitsInfo:locale }}

API

class DecimalPipe implements PipeTransform {
  constructor(_locale: string): DecimalPipe;
  transform(value: string | number, digitsInfo?: string | undefined, locale?: string | undefined): string | null;
  transform(value: null | undefined, digitsInfo?: string | undefined, locale?: string | undefined): null;
  transform(value: string | number | null | undefined, digitsInfo?: string | undefined, locale?: string | undefined): string | null;
}

constructor

DecimalPipe

@param_localestring

@returnsDecimalPipe

transform

3 перегрузки

@paramvaluestring | number

Значение для форматирования.

@paramdigitsInfostring | undefined

Задает представление цифр и десятичных знаков. Подробнее.

@paramlocalestring | undefined

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

@returnsstring | null

@paramvaluenull | undefined

@paramdigitsInfostring | undefined

@paramlocalestring | undefined

@returnsnull

@paramvaluestring | number | null | undefined

@paramdigitsInfostring | undefined

@paramlocalestring | undefined

@returnsstring | null

Описание

Экспортируется из

CommonModule

Примечания по использованию

digitsInfo

Десятичное представление значения задается параметром digitsInfo в следующем формате:

{minIntegerDigits}.{minFractionDigits}-{maxFractionDigits}

minIntegerDigits: минимальное количество целых цифр до десятичной точки. По умолчанию — 1.
minFractionDigits: минимальное количество цифр после десятичной точки. По умолчанию — 0.
maxFractionDigits: максимальное количество цифр после десятичной точки. По умолчанию — 3.

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

{{3.6 | number: '1.0-0'}}
<!--will output '4'-->

{{-3.6 | number:'1.0-0'}}
<!--will output '-4'-->

locale

locale форматирует значение в соответствии с правилами локали. Локаль определяет размер групп и разделитель, символ десятичной точки и другие настройки, зависящие от локали.

Если значение не указано, используется значение LOCALE_ID, которое по умолчанию равно en-US.

См. Настройка локали приложения.

Пример

В следующем примере показано, как канал преобразует значения в соответствии с различными спецификациями формата, если локаль вызывающего кода по умолчанию — en-US.

@Component({
  selector: 'number-pipe',
  imports: [DecimalPipe],
  template: `<div>
    <p>
      No specified formatting:
      {{ pi | number }}
      <!--output: '3.142'-->
    </p>

    <p>
      With digitsInfo parameter specified:
      {{ pi | number: '4.1-5' }}
      <!--output: '0,003.14159'-->
    </p>

    <p>
      With digitsInfo and locale parameters specified:
      {{ pi | number: '4.1-5' : 'fr' }}
      <!--output: '0 003,14159'-->
    </p>
  </div>`,
})
export class NumberPipeComponent {
  pi: number = 3.14159265359;
}