Attention

TYPO3 v12 has reached end-of-life as of April 30th 2026 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v12 here: TYPO3 ELTS.

round

With this property you can round the value up, down or to a certain number of decimals. For each roundType the according PHP function will be used.

The value will be converted to a float value before applying the selected round method.

Properties

roundType

roundType

Type: string / stdWrap
Default: round

Round method which should be used.

Possible keywords:

ceil: Round the value up to the next integer.
floor: Round the value down to the previous integer.
round: Round the value to the specified number of decimals.

decimals

decimals

Type: integer / stdWrap
Default: 0

Number of decimals the rounded value will have. Only used with the roundType "round". Defaults to 0, so that your input will in that case be rounded up or down to the next integer.

round

round

Type: boolean
Default: 0

Set round = 1 to enable rounding.

Examples

EXT:site_package/Configuration/TypoScript/setup.typoscript

lib.number = TEXT
lib.number {
    value = 3.14159
    stdWrap.round = 1
    stdWrap.round.roundType = round
    stdWrap.round.decimals = 2
}

This returns 3.14.