Format.bytes ViewHelper <f:format.bytes>

Formats an integer with a byte count into human readable form.

Examples

Simple

{fileSize -> f:format.bytes()}
Copied!

123 KB Depending on the value of {fileSize}.

With arguments

{fileSize -> f:format.bytes(decimals: 2, decimalSeparator: '.', thousandsSeparator: ',')}
Copied!

1,023.00 B Depending on the value of {fileSize}.

You may provide an own set of units, like this: B,KB,MB,GB,TB,PB,EB,ZB,YB.

Custom units

{fileSize -> f:format.bytes(units: '{f:translate(\'viewhelper.format.bytes.units\', \'fluid\')}'
Copied!

123 KB Depending on the value of {fileSize}.

Source code

Go to the source code of this ViewHelper: BytesViewHelper.php (GitHub).

Arguments

The following arguments are available for <f:format.bytes>:

Name display Type Default
mixed
mixed
string '.'
string ','
string
value
Type
mixed

The incoming data to convert, or NULL if VH children should be used

decimals
Type
mixed

The number of digits after the decimal point

decimalSeparator
Type
string
Default
'.'

The decimal point character

thousandsSeparator
Type
string
Default
','

The character for grouping the thousand digits

units
Type
string

Comma separated list of available units, default is LocalizationUtility::translate('viewhelper.format.bytes.units', 'fluid')