6/29/2019 Built-in Pipes in Angular ← Alligator.

io

Built-in Pipes in Angular

Pipes in Angular give you an easy way to transform data directly in your templates. You can create your
own custom pipes, and you can also use any of the following ones, which are part of the CommonModule
and available right out of the box:

This post covers Angular 2 and up

Async
The Async pipe automatically subscribes to an Observable or a Promise and returns the emitted values as
they come in:

<ul>
<li *ngFor="let item of data | async">
{{ item.name }}
</li>
</ul>

🐊 Alligator.io recommends ⤵

ⓘ About this affiliate link

Currency
The Currency pipe allows to format numbers in different currencies:

{{ price | currency:'CAD' }}
{{ price | currency:'USD':true }}
{{ price | currency:'EUR':false:3.2-2 }}

https://alligator.io/angular/built-in-pipes-angular/ 1/6
 The first argument is a string with the local currency
6/29/2019
code.
Built-in Pipes in Angular ← Alligator.io

The second possible argument is a boolean to show the that will show either the currency symbol, or the
currency code. The default is false and shows the currency code.

The third possible is a string in the format of the decimal pipe to format the number.

Date
Format date values with the Date pipe:

{{ someDate | date:'medium' }}
{{ someDate | date:'fullDate' }}
{{ someDate | date:'yy' }}
{{ someDate | date:'Hm' }}

You can use a number of symbols to define a custom format, or you can also use a number of predefined
keywords. The available keywords are the following: ‘medium’ , ‘short’ , ‘fullDate’ , ‘longDate’ ,
‘mediumDate’ , ‘shortDate’ , ‘mediumTime’ and ‘shortTime’ .

See the official API reference for a list of symbols.

Decimal
The Decimal pipe formats decimal values:

{{ decimalValue | number:'4.3-5' }}

In the above example ( ‘4.3-5’ ), 4 is for the minimum number of integer digits, 3 is for the minimum
number of fraction digits and 5 is for the maximum number of fraction digits.

Json
The Json pipe is useful for debugging and displays an object as a Json string. It uses JSON.stringify behind
the scenes:

https://alligator.io/angular/built-in-pipes-angular/ 2/6
6/29/2019 Built-in Pipes in Angular ← Alligator.io

{{ someObject | json }}

LowerCase & UpperCase

Covert text to either lower case or upper case with the respective pipe:

{{ user.name | uppercase }}
{{ user.name | lowercase }}

Percent
The Percent pipe transforms a number into it’s percentage value:

{{ decimalValue | percent }}
{{ decimalValue | percent:'3.2-3' }}

The optional argument is a string in the Decimal pipe format.

Slice
Create a subset list or string with the Slice pipe:

{{ someText | slice:3:6 }}
<ul>
<li *ngFor="let item of someList | slice:2">
{{ item }}
</li>
</ul>

The arguments are the start index and the end index. The end index can be omitted, and the resulting list or
string will contain everything from the start index to the end.

👉 There are also 2 more built-in pipes that are currently at the experimental stage: I18nPlural and I18nSelect.
https://alligator.io/angular/built-in-pipes-angular/ 3/6