Date & Time¶

The Date & Time tool returns the current date and time. It gives agents awareness of the current moment, which is essential for time-sensitive tasks, scheduling, logging, and answering questions about "now."

Ports¶

Inputs¶

The Date & Time tool has no inputs. It takes no parameters from the agent's LLM -- the tool simply returns the current timestamp when called.

Outputs¶

The output format is YYYY-MM-DD HH:MM:SS TZ (e.g., 2026-02-16 14:30:00 UTC).

Configuration¶

The Date & Time tool accepts the following optional configuration in extra_config:

Example extra_config¶

{
  "timezone": "America/New_York"
}

If no timezone is configured, the tool defaults to UTC.

Usage¶

1. Add a Date & Time node from the Node Palette
2. Connect it to an agent node via the green diamond tools handle
3. Optionally set a timezone in the node's Extra Config field

The agent's LLM can then call the get_datetime tool with no arguments to get the current time.

Example¶

An agent answering "What time is it?":

get_datetime()

Returns (with default UTC timezone):

2026-02-16 14:30:00 UTC

With timezone set to Asia/Tokyo:

2026-02-16 23:30:00 JST

flowchart LR
    T[Chat Trigger] --> A[Agent]
    M[AI Model] -.->|model| A
    DT[Date & Time] -.->|tool| A