Скачать или смотреть How to Format a Number to Currency in pt-br Locale

Learn how to correctly format numbers as currency in Brazilian Real using JavaScript's `toLocaleString` method tailored for the `pt-br` locale.
---
This video is based on the question https://stackoverflow.com/q/66307763/ asked by the user 'Ruan Duarte' ( https://stackoverflow.com/u/11980251/ ) and on the answer https://stackoverflow.com/a/66308317/ provided by the user 'Janez Kuhar' ( https://stackoverflow.com/u/6367213/ ) at 'Stack Overflow' website. Thanks to these great users and Stackexchange community for their contributions.

Visit these links for original content and any more details, such as alternate solutions, latest updates/developments on topic, comments, revision history etc. For example, the original title of the Question was: Format number to currency in locale pt-br

Also, Content (except music) licensed under CC BY-SA https://meta.stackexchange.com/help/l...
The original Question post is licensed under the 'CC BY-SA 4.0' ( https://creativecommons.org/licenses/... ) license, and the original Answer post is licensed under the 'CC BY-SA 4.0' ( https://creativecommons.org/licenses/... ) license.

If anything seems off to you, please feel free to write me at vlogize [AT] gmail [DOT] com.
---
Formatting Numbers to Currency in Brazilian Real (BRL)

When working with monetary values in programming, ensuring they display correctly is paramount—especially for different locales. In this post, we will address a common issue when formatting numbers for Brazilian currency. Specifically, we will explore how to display values in Brazilian Real (R$), tailored specifically for the pt-br locale.

The Problem

Many developers face the challenge of converting a numeric string into a formatted currency string. In this particular case, you might be trying to format the number 25990 in such a way that it represents R$ 259,90, which reflects the value in real terms (with cents).

Initially, a straightforward approach might involve using the toLocaleString method in JavaScript:

[[See Video to Reveal this Text or Code Snippet]]

This would yield an output of R$ 25.990,00, which is not what we want since this representation displays the number as if it were actual Brazilian Reais rather than centavos. So how can we solve this problem?

The Solution

The key to formatting the number correctly lies in understanding how the BRL currency scale works. One real consists of 100 centavos. Therefore, if your base number is stored as centavos (like 25990), you need to convert it into reals first. Here’s how to do that step by step:

Step 1: Convert Centavos to Reals

To convert the centavos value into reals, simply divide it by 100.

Step 2: Format Using toLocaleString

After converting to reals, you can format the value using the toLocaleString method specifying the pt-br locale. The full code will look like this:

[[See Video to Reveal this Text or Code Snippet]]

Why This Works

Currency System: Understanding that 1 real = 100 centavos is crucial. By dividing your centavos amount, you accurately convert it to the correct real value.

Locale-Sensitivity: The toLocaleString method tailors the output based on the specified locale. In our case, using 'pt-br' ensures that the formatting adheres to Brazilian standards (e.g., using commas for decimals).

Styling: Adding the style: 'currency' and specifying the currency ensures the output prefixes the number with R$, confirming its monetary value.

Conclusion

Formatting currency can seem daunting at first, especially with the peculiarities of different locales. However, with a clear understanding of how to transform centavos into reals and the proper use of JavaScript’s locale-specific functions, you can easily display monetary amounts correctly.

Feel free to experiment with other values and see how they format in your applications. This method is not just limited to Brazilian currency but can also be adapted for other locales by simply changing the locale string.

Remember, formatting values correctly enhances the user experience and ensures clarity in financial communication!