formatCurrency
Formats a number as currency using locale rules.
API
function formatCurrency( value: number, locale: string, currency: string, currencyCode?: string | undefined, digitsInfo?: string | undefined, ): string;
numberThe number to format.
stringA locale code for the locale format rules to use.
stringA string containing the currency symbol or its name, such as "$" or "Canadian Dollar". Used in output string, but does not affect the operation of the function.
string | undefinedThe ISO 4217 currency code, such as USD for the US dollar and EUR for the euro. Used to determine the number of digits in the decimal part.
string | undefinedDecimal representation options, specified by a string in the following format: {minIntegerDigits}.{minFractionDigits}-{maxFractionDigits}. See DecimalPipe for more details.
stringThe formatted currency value.
Super-powered by Google ©2010–2025.
Code licensed under an MIT-style License. Documentation licensed under CC BY 4.0.
https://angular.dev/api/common/formatCurrency