Skip to main content

Input Time Node

The Input Time Node allows the user to select or enter a specific time. It ensures consistent formatting, localization, and validation for time inputs across all TellUs and WebChat interactions.

Use Case​

Use this node when the flow requires users to specify a particular time of day.
Common insurance-related examples include:

  • Selecting the time of an accident in a motor claim
  • Recording when damage was discovered for property claims
  • Scheduling a callback or inspection time
  • Logging the time of a medical event or appointment

Avoid using this node for full timestamps (date + time together) — that’s better handled by date time node.

UI Examples​

Node in TellUs

Behavior​

  • Blocking: ✅ Yes — the flow waits until the user provides and confirms a time.
  • User input required: ⚙️ Configurable with isRequired.
  • Validation: Enforces correct time format and prevents selecting future times when shouldNotExeedNow is enabled.
  • Localization: Time format masks (e.g., HH, MM) automatically adapt to the user’s language.
  • Output: The formatted time can be stored and referenced later in the flow.

When editing the node:

  • Define the time masks (hour and minute format) to control how the input appears.
  • Configure labels and validation messages for each language.
  • Set constraints such as disallowing times in the future (shouldNotExeedNow).

Node Metadata​

PropertyDescription
Node classInputTimeNode
MessageType5
CanBeEditedTrue
CanBeProcessedOnceFalse
RequireUserResponseYes

Input Properties​

PropertyDescription
shouldNotExeedNow

Prevents users from selecting a time that is later than the current time. Commonly used when capturing an event that has already occurred (e.g., “Time of accident”).

  • Default Values:
      • En:false
  • Allowed Values:
      • true
      • false
exeedsNowMessage

The message displayed when the user selects a time that exceeds the current time while shouldNotExeedNow is enabled.

  • Default Values:
      • En:Time should not exceed current time
      • No:Time should not exceed current time
      • Dk:Time should not exceed current time
      • Fi:Kellonaika ei voi olla tulevaisuudessa
      • Se:Angivna tiden får inte överstiga aktuell tid idag!
date

The associated date value for which this time applies. This can be used to combine date and time selections in a single logical context.

dateFormat

Defines the format used for displaying or parsing the date when it’s part of the input (e.g., dd.MM.yyyy).

  • Default Values:
      • En:dd.MM.yyyy
timeZoneId

Specifies the time zone context for the input and validation. Ensures that times are interpreted correctly across different regions.

  • Default Values:
      • En:FLE Standard Time
hourMask

Controls how hours are displayed in the input field (e.g., HH, TT). Adjusts based on locale.

  • Default Values:
      • En:HH
      • No:TT
      • Dk:TT
      • Fi:TT
      • Se:TT
minutesMask

Controls how minutes are displayed in the input field (e.g., MM). Localized for each supported language.

  • Default Values:
      • En:MM
      • No:MM
      • Dk:MM
      • Fi:MM
      • Se:MM
hours

The localized label or placeholder for the hours input (e.g., “Hours”, “Timer”).

  • Default Values:
      • En:Hours
      • No:Timer
      • Dk:Time
      • Fi:Tunnit
      • Se:Timmar
minutes

The localized label or placeholder for the minutes input (e.g., “Minutes”, “Minutter”).

  • Default Values:
      • En:Minutes
      • No:Minutter
      • Dk:Minutter
      • Fi:Minuutit
      • Se:Minuter
defaultValidationMessage

The default error message shown when the input is invalid or missing. This is used if no custom validation message is provided.

  • Default Values:
      • En:Invalid time format
      • No:Ugyldig tidsformat
      • Dk:Ugyldigt tidsformat
      • Fi:Kellonaika ei kelpaa
      • Se:Kontrollera format
sectionId

Groups this node visually under a specific section in TellUs. When multiple nodes share the same sectionId, they are displayed together under a shared header.

defaultValue

The initial value that is prefilled into the input field when the node is rendered. Useful for suggesting defaults or pre-populating known data.

isRequired

Determines whether the user must provide a value before continuing. If set to true, the form will not proceed without input.

  • Default Values:
      • En:true
  • Allowed Values:
      • true
      • false
isRequiredValidationMessage

The error message shown when a required field is left empty. This overrides the default validation message when isRequired is true.

  • Default Values:
      • En:Value is required
      • No:Verdi er påkrevd
      • Dk:Værdi er påkrævet
      • Fi:Arvo vaaditaan
      • Se:Värde krävs

Output Properties​

PropertyDescription
displayValue

The formatted time string as seen by the user (e.g., “14:30”). Can be referenced later in the flow, for example [accidentTime.displayValue].

Editor Example​

Try it in the Atlas Editor

This link opens a prebuilt flow using this node in context. You can inspect how it's configured, how it's connected, and how it behaves in a real editor environment.

Editor