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: Format\BytesViewHelper.php (GitHub).

Arguments

The following arguments are available for the format.bytes ViewHelper:

value
Type
int
The incoming data to convert, or NULL if VH children should be used
decimals
Type
int
Default
0
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')