home-assistant.io/source/_integrations/time_date.markdown

title	description	ha_category	ha_iot_class	ha_release	ha_quality_scale	ha_config_flow	ha_codeowners	ha_domain	ha_platforms	ha_integration_type
Time & Date	Instructions on how to create time and the date sensors within Home Assistant.	Calendar	Local Push	pre 0.7	internal	true	@fabaff	time_date	sensor	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.

{% raw %}

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 on the templating page.