W3cubDocs

/Angular 2 TypeScript

CurrencyPipe

Stable Pipe

What it does

Formats a number as currency using locale rules.

How to use

number_expression | currency[:currencyCode[:symbolDisplay[:digitInfo]]]

NgModule

CommonModule

Description

Use currency to format a number as currency.

  • currencyCode is the ISO 4217 currency code, such as USD for the US dollar and EUR for the euro.
  • symbolDisplay is a boolean indicating whether to use the currency symbol or code.
    • true: use symbol (e.g. $).
    • false(default): use code (e.g. USD).
  • digitInfo See DecimalPipe for detailed description.

WARNING: this pipe uses the Internationalization API which is not yet available in all browsers and may require a polyfill. See Browser support for details.

Example

@Component({
  selector: 'currency-pipe',
  template: `<div>
    <p>A: {{a | currency:'USD':false}}</p>
    <p>B: {{b | currency:'USD':true:'4.2-2'}}</p>
  </div>`
})
export class CurrencyPipeComponent {
  a: number = 0.259;
  b: number = 1.3495;
}

exported from @angular/common/index defined in @angular/common/src/pipes/number_pipe.ts

© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v2.angular.io/docs/ts/latest/api/common/index/CurrencyPipe-pipe.html