jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-24 01:37:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update time_date.markdown (#24158)

Browse Source 
Clarified what this interation is about
This commit is contained in:
Martin 2022-09-17 23:52:02 +02:00 committed by GitHub
parent c335040abb
commit 7d4cdbc64d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 3 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
source/_integrations/time_date.markdown
View File

@ -1,6 +1,6 @@
---
title: Time & Date
description: Instructions on how to integrate the time and the date within Home Assistant.
description: Instructions on how to create time and the date sensors within Home Assistant.
ha_category:
- Calendar
ha_iot_class: Local Push
@ -14,7 +14,7 @@ ha_platforms:
ha_integration_type: integration
---
The time and date (`time_date`) integration allows one to show the current date or time in different formats. All values are based on the timezone which is set in "General Configuration".
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".
To have these sensors available in your installation, add the following to your `configuration.yaml` file (each option creates a separate sensor that contains appropriate data, e.g., `sensor.date` for the `date` option):
@ -36,7 +36,7 @@ sensor:
{% configuration %}
display_options:
description: The option to display. The types *date_time*, *date_time_utc*, *time_date*, and *date_time_iso* shows the date and the time. The other types just the time or the date. *beat* shows the [Swatch Internet Time](https://en.wikipedia.org/wiki/Swatch_Internet_Time).
description: The sensors to create. The types *date_time*, *date_time_utc*, *time_date*, and *date_time_iso* create combined date and the time sensors. The other types just the time sensor or the date sensor. *beat* creates the [Swatch Internet Time](https://en.wikipedia.org/wiki/Swatch_Internet_Time).
required: true
type: list
{% endconfiguration %}
@ -50,8 +50,6 @@ Sensors including the time update every minute, the date sensor updates each day
# Producing your own custom time and date sensor
Whilst there are a number of `display_options` exposed by this sensor, they cannot hope to satisfy everyone, and large parts of the world will find that their local display conventions are not included.
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 %}