Datetime Tablefield

A date and time picker column for collecting temporal values with various precision levels (date, datetime, time, month, year) within a table row.

Properties

Attribute Comments
basic
name
string / required / unique

Field name
Alfanumeric + underscore + dash

This attribute represents the name of the form field.
type
string / required

Tablefield type

Other attributes might only be available for some tablefield types.

Choices:
  • text
  • textarea
  • number
  • password
  • checkbox
  • datetime
  • enum
label
string

Tablefield label
Free text

A friendly name/label for the tablefield
placeholder
string

In-field help value
Free text

Some form fields allow an in-field hint value.
data
default
many

Default value

The type of the value depends on the field type.
Can be string,boolean, number, array or object. When using an enum field, you can use the following special values :

  • __auto__ : select the first
  • __none__ : select none
  • __all__ : select all (if multiple is true)
datetime
dateType
string
added in version 4.0.2

DateType of the datetime picker

The datetime picker can pick several types

Choices:
  • date
  • datetime
  • time
  • month
  • year
convertToUtc
boolean
added in version 6.1.4

Convert datetime to UTC

When enabled, the selected date/time will be converted to UTC timezone before being sent to Ansible. When disabled, the date/time will be used as entered without timezone conversion (local time as ISO string without timezone info).

Important: Only works when dateType is set to datetime. Has no effect for other dateTypes (date, year, month, week, time).

Use case: If a user in GMT+2 timezone picks 14:00 with convertToUtc enabled, the field will show 14:00 but the output will be 12:00 UTC (timezone-aware conversion). Without conversion, the output would be 14:00 (server’s local time).

Default:
false
interaction
validation
required
boolean

Required field

Makes the field required.

Default:
false
regex
object

A regular expression validation

Enforces a validation where the current field must match a regular expression. This field requires an object with 2 attributes:

  • expression : The regular expression
  • description : A validation message to show when the regex is not matched.
notIn
object
added in version 2.2.4

A list validation (can not be in list)

Enforces a validation where the current field can not be one of the values in a list (referencing another field). This field requires an object with 2 attributes:

  • field : The name of the field that holds the list
  • description : A validation message to show when the validation is not met. (new in v5.0.1 : can have placeholder)
in
object
added in version 2.2.4

A list validation (must be in list)

Enforces a validation where the current field must be one of the values in a list (referencing another field). This field requires an object with 2 attributes:

  • field : The name of the field that holds the list
  • description : A validation message to show when the validation is not met. (new in v5.0.1 : can have placeholder)
visualization
icon
string

Field icon
Free fontawesome 6 icon

Some tablefields can hold a nice looking icon. The icon name is a free fontawesome 6 icon. You can find more information at www.fontawesome.com

Examples

Copyright © 2023-2026 AnsibleForms. All rights reserved.