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:

decimalSeparator

decimalSeparator
Type
string
Default
'.'
The decimal point character

decimals

decimals
Type
int
Default
0
The number of digits after the decimal point

thousandsSeparator

thousandsSeparator
Type
string
Default
','
The character for grouping the thousand digits

units

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

value

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