---
title: Time & Date
description: Instructions on how to create time and the date sensors within Home Assistant.
ha_category:
- Calendar
ha_iot_class: Local Push
ha_release: pre 0.7
ha_quality_scale: internal
ha_config_flow: true
ha_codeowners:
- '@fabaff'
ha_domain: time_date
ha_platforms:
- sensor
ha_integration_type: service
---
The time and date (`time_date`) integration allows one to create sensors for the current date or time in different formats. All values are based on the timezone which is set in "General Configuration".
{% include integrations/config_flow.md %}
Sensors including the time update every minute, the date sensor updates each day at midnight.
# Producing your own custom time and date sensor
The following can be used to create a time and date sensor whose output can be properly customised to use your own preferred formatting, specified in the call to timestamp_custom() using standard [Python datetime formatting](https://docs.python.org/3.8/library/datetime.html#strftime-and-strptime-behavior).
{% raw %}
```yaml
sensor:
# Minimal configuration of the standard time and date sensor
- platform: time_date
display_options:
- 'date_time_iso'
# Build on the standard sensor to produce one that can be customized
template:
- sensor:
- name: "Date and time"
state: "{{ as_timestamp(states('sensor.date_time_iso')) | timestamp_custom('%A %B %-d, %I:%M %p') }}"
icon: "mdi:calendar-clock"
```
{% endraw %}
## More time-related resources
For more information about using time related variables and sensors in templates (such as `today_at()`, `now()` or `as_timestamp()`) visit this [time section](/docs/configuration/templating/#time) on the templating page.