Add timestamp option for input_datetime.set_datetime (#14308)

source/_integrations/input_datetime.markdown

@@ -88,21 +88,25 @@ If you set a valid value for `initial` this integration will start with state se
 
 Available service: `input_datetime.set_datetime` and `input_datetime.reload`.
 
+#### input_datetime.set_datetime
+
 Service data attribute | Format String | Description
 -|-|-
 `date` | `%Y-%m-%d` | This can be used to dynamically set the date.
 `time` | `%H:%M:%S` | This can be used to dynamically set the time.
 `datetime` | `%Y-%m-%d %H:%M:%S` | This can be used to dynamically set both the date & time.
+`timestamp` | N/A | This can be used to dynamically set both the date & time using a UNIX timestamp.
 
-To set both the date and time in the same call, use `date` and `time` together, or use `datetime` by itself. Using `datetime` has the advantage that both can be set using one template.
+To set both the date and time in the same call, use `date` and `time` together, or use `datetime` or `timestamp` by itself. Using `datetime` or `timestamp` has the advantage that both can be set using one template.
+
+#### input_datetime.reload
 
 `input_dateteime.reload` service allows one to reload `input_datetime`'s configuration without restarting Home Assistant itself.
 
-## Automation Examples
+## Examples
 
 The following example shows the usage of the `input_datetime` as a trigger in an
-automation (note that you will need a
+automation:
-[time sensor](/integrations/time_date) elsewhere in your configuration):
 
 {% raw %}
 ```yaml
@@ -110,56 +114,56 @@ automation (note that you will need a
 # Turns on bedroom light at the time specified.
 automation:
   trigger:
-    platform: template
+    platform: time
-    value_template: "{{ states('sensor.time') == (state_attr('input_datetime.bedroom_alarm_clock_time', 'timestamp') | int | timestamp_custom('%H:%M', False)) }}"
+    at: input_datetime.bedroom_alarm_clock_time
-  action:
+  action:
     service: light.turn_on
     entity_id: light.bedroom
 ```
 {% endraw %}
 
 To dynamically set the `input_datetime` you can call
-`input_datetime.set_datetime`. The values for `date` and `time` must be in a certain format for the call to be successful. (See service description above.)
+`input_datetime.set_datetime`. The values for `date`, `time` and/or `datetime` must be in a certain format for the call to be successful. (See service description above.)
-If you have a `datetime` object you can use its `strftime` method. Of if you have a timestamp you can use the `timestamp_custom` filter.
+If you have a `datetime` object you can use its `timestamp` method. Of if you have a timestamp you can just use it directly.
-The following example shows the different methods in an automation rule:
 
 {% raw %}
 ```yaml
-# Example configuration.yaml entry
+# Sets time to 05:30:00
-# Shows different ways to set input_datetime when an input_boolean is turned on
+- service: input_datetime.set_datetime
-automation:
+  entity_id: input_datetime.XXX
-  trigger:
+  data:
-    platform: state
+    time: '05:30:00'
-    entity_id: input_boolean.example
+# Sets time to time from datetime object
-    to: 'on'
+- service: input_datetime.set_datetime
-  action:
+  entity_id: input_datetime.XXX
-  # Sets time to '05:30:00
+  data:
-  - service: input_datetime.set_datetime
+    time: "{{ now().strftime('%H:%M:%S') }}"
-    entity_id: input_datetime.bedroom_alarm_clock_time
+# Sets date to 2020-08-24
-    data:
+- service: input_datetime.set_datetime
-      time: '05:30:00'
+  entity_id: input_datetime.XXX
-   # Sets time to time from datetime object (current time in this example)
+  data:
-  - service: input_datetime.set_datetime
+    date: '2020-08-24'
-    entity_id: input_datetime.another_time
+# Sets date to date from datetime object
-    data:
+- service: input_datetime.set_datetime
-      time: "{{ now().strftime('%H:%M:%S') }}"
+  entity_id: input_datetime.XXX
-  # Sets date to date from timestamp (current date in this example)
+  data:
-  - service: input_datetime.set_datetime
+    date: "{{ now().strftime('%Y-%m-%d') }}"
-    entity_id: input_datetime.another_date
+# Sets date and time to 2020-08-25 05:30:00
-    data:
+- service: input_datetime.set_datetime
-      date: "{{ as_timestamp(now())|timestamp_custom('%Y-%m-%d') }}"
+  entity_id: input_datetime.XXX
-  # Sets date and time to date and time from datetime object (current date and time in this example)
+  data:
-  - service: input_datetime.set_datetime
+    datetime: '2020-08-25 05:30:00'
-    entity_id: input_datetime.date_and_time
+# Sets date and time from datetime object
-    data:
+- service: input_datetime.set_datetime
-      datetime: "{{ now().strftime('%Y-%m-%d %H:%M:%S') }}"
+  entity_id: input_datetime.XXX
-  # Sets date and time to date and time from timestamp (current date and time in this example)
+  data:
-  - service: input_datetime.set_datetime
+    datetime: "{{ now().strftime('%Y-%m-%d %H:%M:%S') }}"
-    data:
+# Sets date and/or time from UNIX timestamp
-      entity_id: input_datetime.date_and_time
+# This can be used whether the input_datetime has just a date,
-      date: >
+# or just a time, or has both
-        {{ now().timestamp() | timestamp_custom("%Y-%m-%d", true) }}
+- service: input_datetime.set_datetime
-      time: >
+  data:
-        {{ now().timestamp() | timestamp_custom("%H:%M:%S", true) }}
+    entity_id: input_datetime.XXX
+    timestamp: "{{ now().timestamp() }}"
 ```
 {% endraw %}