In website operation, the way of data display is crucial to user experience.Whether it is the price of goods, statistical data, or financial statements, a clear and standardized format of numbers can not only enhance the professionalism of the website, but also help users understand the information more intuitively.Anqi CMS fully understands this need, and provides powerful number formatting features in the template system, allowing us to easily control the decimal places of floating-point numbers, the display style of integers, and more customized number presentations.

Why is number formatting so important?

Imagine, for a moment, a product price displayed on an e-commerce website as '199.9999 yuan' or '$20.00000', which无疑会给用户带来困惑. This would undoubtedly confuse the user.Similarly, if the data is displayed as "1234567", but we want it to be presented as "1,234,567", the lack of formatting will make the data difficult to read.The AnQi CMS number formatting feature is designed to solve these problems, helping us finely control the display effect of every number on the website, making the data more in line with actual business scenarios and user habits.

Flexibly control decimal places: floatformat filter

When we need to control the decimal places of floating-point numbers, such as displaying currency prices or percentages uniformly,floatformatThe filter is the preferred tool provided by Anqi CMS. This filter is specifically designed to handle floating-point numbers and can retain the specified number of decimal places according to our needs.

Its basic usage is to add it after the variable that needs to be formatted|floatformat:Nof whichNRepresents the number of decimal places you want to keep

For example, suppose your product price variableproductPriceThe value is34.23234:

  • Default behavior:If you do not specify the number of decimal places, i.e.{{ productPrice|floatformat }}it will try to keep one decimal place, and if the last digit is zero, it will directly remove the decimal part, for example34.2or34. If the price of your product is34.00000It will be displayed as34If it is34.26000It will be rounded to34.3.

  • Specify the number of decimal places:When you want to control the number of decimal places accurately, you can provide a positive integer as a parameter. For example,{{ productPrice|floatformat:3 }}Will34.23234Formatted as34.232while34.00000It will be displayed as34.000This is very useful when displaying financial data that requires fixed decimal places.

floatformatThe filter is very intelligent, it can correctly identify and format whether your variable is a direct number type or a number in string form.

Satisfy advanced formatting requirements: stringformat filter

floatformatThe filter performs well in controlling the decimal places of floating-point numbers, but if you have broader needs for number formatting, such as inserting numbers into a specific text template, or need to follow C languageprintfFormatting rules of style, thenstringformatThe filter will be your best choice.

stringformatThe filter provides something similar to Go language infmt.Sprintf()The powerful function allows you to output any value (including numbers, strings, etc.) in the format you define.

Its usage syntax is{{ 变量名|stringformat:"格式定义" }}Where 'Format Definition' is a string that includes various formatting placeholders.

Common format definitions used for numbers include:

  • %d: is used for formatting integers. For example,{{ someInteger|stringformat:"%d" }}Converts an integer888Output is888.
  • %f: Used to format floating-point numbers. For example,{{ someFloat|stringformat:"%f" }}Will3.141592653Output is3.141593.
  • %.Nf: Used to format floating-point numbers and specify the number ofNdecimal places. This is similar to thefloatformateffect, but provides finer control. For example,{{ someFloat|stringformat:"%.2f" }}Will3.141592653Output is3.14.

stringformatThe power lies in its ability to mix numbers with other text formatting. For example, if you want to display a number as "Test result: 888", you can use it like this:{{ someInteger|stringformat:"测试结果：%d" }}This makes it very flexible when creating dynamic copywriting.

Combined usage: preprocessing and formatting

Sometimes, the data you get from the backend may not be a standard numeric type, but exists in string form. In this case, AnQi CMS also providesintegerandfloatA filter that is used to convert these strings to their corresponding numeric types before formatting.

For example, if yourproductPricevariable is originally a string"34.23234", you can use it first tofloatThe filter converts it to a floating-point number and then usesfloatformatPerform decimal place control:

{# 假设 productPrice 变量为字符串 "34.23234" #}
{{ productPrice|float|floatformat:2 }}

Similarly, if a string"123"needs to be confirmed as an integer for subsequent operations,{{ "123"|integer }}the conversion can be completed.

Summary

Anqi CMS passedfloatformatandstringformatThese powerful filters provide us with flexible and precise number formatting capabilities.No matter whether it is to simplify the decimal places of floating-point numbers or integrate numbers into complex text output, we can always find the right tool.These meticulous features help us build more professional and user-friendly websites, displaying data in the clearest and most expected form for visitors.

Frequently Asked Questions (FAQ)

  1. Q:floatformatandstringformatWhat are the main differences in number formatting between filters?A:floatformatThe filter is mainly used for retaining and rounding specific decimal places of floating-point numbers, especially suitable for quickly adjusting the decimal display of numbers. Its default behavior is to remove the trailing zeros.stringformatThe filter is more general, it allows you to use various placeholders as in programming languages,printflike functions,%d/%f/%.2fTo define the output string format for numbers or any other type of value, it is more suitable for scenarios where numbers need to be embedded in complex text or for multi-type formatting conversion.

  2. Q: If I get a text string from the backend, such as "123.45", I can use it directlyfloatformat?A: Yes, you can.floatformatThe filter is sufficiently intelligent, it can identify numbers in string format and convert them to floating-point numbers for formatting. However, to ensure data accuracy and robustness, if you are sure that the variable is a number but exists in string format, you can also choose to usefloatExplicit conversion of filters, for example{{ "123.45"|float|floatformat:2 }}.

  3. Q: I see there is also astampToDatelabel, is it related to number formatting?A:stampToDateThe label and number formatting are different, it is specifically used to convert timestamps (usually an integer or a long integer) into a readable date and time format. For example,{{ stampToDate(1678886400, "2006-01-02 15:04") }}It will format the timestamp as "2023-03-15 15:04". Although the timestamp itself is a number, butstampToDateThe purpose is to present it as a date-time string rather than a mere numeric format adjustment.