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'
      ],
   ],
],

'aField' => [
   'config' => [
      'type' => 'none',
      'format' => 'float'
      'format.' => [
         'precision' => 8
      ],
   ],
],