This is the archived documentation for Angular v6. Please visit angular.io to see documentation for the current version of Angular.
API > @angular/common

I18nPluralPipe

Maps a value to a string that pluralizes the value according to locale rules.

{{ value_expression | i18nPlural : pluralMap [ : locale ] }}
      
      {{ value_expression | i18nPlural : pluralMap [ : locale ] }}

NgModule

Input value

value number

the number to be formatted

Parameters

pluralMap { [count: string]: string; }

an object that mimics the ICU format, see http://userguide.icu-project.org/formatparse/messages.
locale string

a string defining the locale to use (uses the current LOCALE_ID by default).

Optional. Default is undefined.

Usage notes

Example

@Component({ selector: 'i18n-plural-pipe', template: `<div>{{ messages.length | i18nPlural: messageMapping }}</div>` }) export class I18nPluralPipeComponent { messages: any[] = ['Message 1']; messageMapping: {[k: string]: string} = {'=0': 'No messages.', '=1': 'One message.', 'other': '# messages.'}; } 
      
      @Component({
  selector: 'i18n-plural-pipe',
  template: `<div>{{ messages.length | i18nPlural: messageMapping }}</div>`
})
export class I18nPluralPipeComponent {
  messages: any[] = ['Message 1'];
  messageMapping:
      {[k: string]: string} = {'=0': 'No messages.', '=1': 'One message.', 'other': '# messages.'};
}