Skip to content

Current Date and Time

Simple native tool that returns the current date and time in GMT (UTC+0) when the agent needs to know “what day/hour is now”.

Language models don’t have real notion of present time — they know up to a training cutoff. Without this tool, the agent may invent the date or use a stale reference.

  • Scheduling: agent that books meetings, creates reminders, or calculates deadlines.
  • Support that needs to say “today”, “tomorrow”, “last week” accurately.
  • Responses involving promotions with expiration date, coupon validity, return deadlines.
  • Any agent that benefits from knowing the day of week, month, current year.
  • Contextual greetings (“good morning”, “good evening”) based on the hour.
  1. In the agent’s Tools tab, click + Add Tool.
  2. Under NATIVE TOOLS, pick Current Date and Time.

No parameters, no configuration. The tool is active immediately.

The agent decides to call this tool when the question or task depends on the current moment:

  • “what day is today?”
  • “what’s the deadline if delivery is in 5 business days?”
  • “is this coupon still valid?”
  • “set a reminder for tomorrow morning”

The return is a timestamp in GMT (UTC+0). The agent tells the user the time is in GMT so they can convert to local timezone when needed.

  • Fixed at GMT/UTC. The tool doesn’t detect the user’s timezone. If you need local time, guide the agent in the prompt to ask the timezone or always apply an offset (e.g., “use America/Sao_Paulo, UTC-3”).
  • No automatic local time. To personalize per user (e.g., “good evening” based on their tz), store the timezone in a conversation note or in the profile and guide the agent to use it.
  • No extra cost. The call is cheap and fast — returns in milliseconds.
  • Watch out for date arithmetic. The model isn’t perfect at calendar math (business days, holidays). For critical cases, validate on your application side.