pnz/twig-extension-number

A Twig extension for number formatting

2.0.0-rc1 2021-01-20 17:42 UTC

Requires

• php: >=7.2.5
• twig/twig: ^2.4 || ^3.0

Requires (Dev)

• phpunit/phpunit: ^8.5 || ^9.5

MIT

• thePanz

• i18n
• number

README

A Twig extension to handle number formatting.

Included filters:

• format_bytes Formats the given amount as bytes and display it in an as a human-readable format. The filter supports 1000/1024 base counting and formatting
• format_grams Formats the given amount as "grams" in a human-readable format
• format_meters Formats the given amount as "meters" in a human-readable format

Examples

Display the value of 4000 grams in a human-readable format (4.00 Kg):

{{ 4000 | format_grams }}

The filter allows some customization of the output, given its signature filter_grams(decimals, unityBias):

• Decimals: Display the value of 4000 grams in a human-readable format with 3 decimals (4.000 Kg):

  {{ 4000 | format_grams(3) }}
  

• UnityBias: Set the filter to handle the number as being expressed with a different bias then the standard unit (grams). To display the value of 4000 (expressed in milligrams, 1E-3) as grams in a human-readable format with 3 decimals (4.00 g) use:

  {{ 4000 | format_grams(3, 1E-3) }}
  

Install

Via composer:

    composer require "pnz/twig-extension-number"

In Symfony, tag Pnz\TwigExtensionNumber\Number with twig.extension, and the filter will be automatically registered.

    # file: config/services.yaml
    Pnz\TwigExtensionNumber\Number:
        tags: ['twig.extension']