Skip to main content

Temporal Awareness (Date & Time)

For an AI to be truly helpful, it needs to understand the concept of time. Open WebUI provides models with the current date, time, and timezone so they can deliver contextually relevant answers (e.g., "What's on my schedule today?" or "Summarize my meetings from yesterday").

System-Level Awareness​

Nothing about the date or time reaches the model on its own. It arrives only where a system prompt, model file or prompt contains one of these placeholders, which Open WebUI fills in before the request is sent:

  • CURRENT_DATE: Injected as YYYY-MM-DD.
  • CURRENT_TIME: HH:MM:SS in the browser's local 24-hour time for chats from the interface. Requests that arrive without browser variables (API calls, automations, timers) get the server's local time as hh:MM:SS AM/PM.
  • CURRENT_DATETIME: date and time together. CURRENT_TIMEZONE and USER_LANGUAGE are filled only by the browser, so they stay literal for API callers, automations and timers.
  • CURRENT_WEEKDAY: (e.g., Monday, Tuesday).

These variables can be manually used in Prompts or Model Files using the {{CURRENT_DATE}} syntax.

Native Temporal Tools (Agentic)​

When using a model with Native Function Calling enabled (see the Central Tool Calling Guide), models gain granular control over time calculations and queries.

Available Time Tools:​

  • get_current_timestamp: The model can retrieve the exact current Unix timestamp (UTC) and ISO date string.
  • calculate_timestamp: subtracts a number of days, weeks, months or years from now (for example "the date 3 days ago"). It cannot compute a future date such as "next Friday". The model has to reason that from get_current_timestamp, which also returns the user's local time and timezone when the profile has one.

Why use native tool calling for Time?​

While static variables tell the model "when it is now," native tools allow the model to reason about time.

If you ask: "Find the notes I wrote last Tuesday," a model without tools might guess the date incorrectly. A tool-equipped model will:

  1. Calculate the exact date of "last Tuesday" using calculate_timestamp.
  2. Search your notes using that specific date as a filter via search_notes.

This precision is essential for reliable agentic workflows that involve searching history, scheduling tasks, or analyzing time-sensitive data.

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.