format

format
Path

$GLOBALS['TCA'][$table]['columns'][$field]['config']

type

string (keyword) + array

Scope

Display

The value of a none-type fields is normally displayed as is. It is however possible to format it using this property. The following keywords are available, some having sub-properties. Sub-properties are called with the format. keyword (note the trailing dot), which in itself is an array.

date

Formats the value of the field as a date. The default formatting uses PHP's date() function and d-m-Y as a format.

Possible options are:

strftime
(boolean) If true, strftime() is used instead date() for formatting.
option
(string) Format string (i.e. Y-m-d or %x, etc.).
appendAge
(boolean) If true, the age of the value is appended is appended to the formatted output.
datetime
Formats the values using PHP's date() function and H:i d-m-Y as a format.
time
Formats the values using PHP's date() function and H:i as a format.
timesec
Formats the values using PHP's date() function and H:i:s as a format.
year
Formats the values using PHP's date() function and Y as a format.
int

Formats the values as an integer using PHP's sprintf() in various bases. The default base is decimal (dec). The base is defined as an option:

base
(string) Defines the base of the value. Possible bases are "dec", "hex", "HEX", "oct" and "bin".
float

Formats the values as an real number using PHP's sprintf() and the %f marker. The number of decimals is an option:

precision
(integer) Defines the number of decimals to use (maximum is 10, default is 2).
number

Formats the values as a number using PHP's sprintf(). The format to use is an option:

option
(string) A format definition according to PHP's sprintf() function (see the reference).
md5
Returns the md5 hash of the values.
filesize

Formats the values as file size using \TYPO3\CMS\Core\Utility\GeneralUtility::formatSize(). One option exists:

appendByteSize
(boolean) If true, the original value is appended to the formatted string (between brackets).
user
Calls a user-defined function to format the values. The only option is the reference to the function:
userFunc
(string) Reference to the user-defined function. The function receives the field configuration and the field's value as parameters.

Examples

'aField' => [
   'config' => [
      'type' => 'none',
      'format' => 'date'
      'format.' => [
         'strftime' => TRUE,
         'option' => '%x'
      ],
   ],
],
Copied!
'aField' => [
   'config' => [
      'type' => 'none',
      'format' => 'float'
      'format.' => [
         'precision' => 8
      ],
   ],
],
Copied!