Time

Time (`time`)

Time processing: parsing and formatting time values.

Transform json

actions:
  - time: {}

JSON

{
  "actions": [
    {
      "time": {}
    }
  ]
}

Field	Type	Description
`description`	`string`	describe this step.
`condition`	`lua-expression` (`string`)	Only run this action if the specified condition is met. Examples: `2 * count()`
`input-field`	`field` (`string`)	Field that provides an input time. If not provided, use current time. Examples: `data_field`
`output-field`	`field` (`string`)	Field to contain time as a string. Examples: `data_field`
`input-timezone`	`string`	If input is provided, this is its timezone.
`output-timezone`	`iana-timezone` (`string`)	Timezone for output time. Examples: `UTC`, `CAT`
`input-format`	`time-format` (`string`)	Time format for input time, if provided.
`input-formats`	`string[]`	Multiple input time formats which will be tried in turn for conversion.
`output-format`	`time-format` (`string`)	Time Format for output time. Default is “%Y-%m-%dT%H:%M:%S%.3fZ”.
`time-range-conditions`	`Time Range Conditions`	Describe how special time ranges are interpreted.
`local`	`Local`	Treat the following fields as using the local timezone, if none are specified the utc timezone is assumed. Allowed values: `input`, `output`, `both`, `utc`
`delta`	`Delta`	Add or subtracts specified amount of time to the timestamp (`now` is used if input-field is not specified).
`zero-time`	`boolean` (`bool`)	Set the time component of the output time to 00:00:00.000.
`suppress-warnings`	`boolean` (`bool`)	Suppress warnings generated by this action.

Option	Name	Type	Description
`add-time`	Add Time	`string`	Field containing the start of the current window.
`subtract-time`	Subtract Time	`string`	Field containing length of the window.

Field	Type	Required	Description
`start-field`	`field` (`string`)	✅	Field containing the start of the current window. Examples: `data_field`
`length-field`	`field` (`string`)	✅	Field containing length of the window. Examples: `data_field`

Field	Type	Required
`times`	`string[]`	✅
`output-fields`	`map` (`object`)
`time-range-output`	`Time Range Output`