pnz/twig-extension-number

A Twig extension for number formatting

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

This package is auto-updated.

Last update: 2024-10-23 02:25:39 UTC


README

Latest Stable Version Total Downloads Latest Unstable Version License Scrutinizer Code Quality

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']