Date and time template functions

These template functions help you work with dates, times, and durations. Use them to get the current time, format timestamps for display, calculate how long ago something happened, or convert between different time representations.

Home Assistant extends the Jinja2 template engine with many custom functions, filters, and tests. Each function on this page has its own page with detailed descriptions, parameters, and practical examples.

New to templates? Start with the templating documentation to learn the basics.

• Convert to datetime as_datetime Converts a string or timestamp to a datetime object.
• Convert to local time zone as_local Converts a datetime object to your local time zone.
• Parse duration string as_timedelta Parses an ISO 8601 duration string into a timedelta object.
• Convert to UNIX timestamp as_timestamp Converts a datetime object or string to a UNIX timestamp.
• Current local date and time now Returns the current date and time in your local time zone.
• Relative time (deprecated) relative_time Returns a human-readable string describing how long ago a datetime was.
• Parse a time string strptime Parses a time string with a specified format into a datetime object.
• Human-readable time elapsed time_since Returns a human-readable string describing how much time has passed since a datetime.
• Human-readable time remaining time_until Returns a human-readable string describing how much time remains until a datetime.
• Create a time duration timedelta Creates a timedelta object from numeric time components.
• Format timestamp with custom format timestamp_custom Formats a UNIX timestamp as a string using a custom format.
• Format timestamp as local time timestamp_local Formats a UNIX timestamp as a local datetime string.
• Format timestamp as UTC time timestamp_utc Formats a UNIX timestamp as a UTC datetime string.
• Today at a specific time today_at Returns today's date combined with a specific time.
• Current UTC date and time utcnow Returns the current date and time in UTC.