Messaggio Data
--------------
``chat_date``
Utilizza questo formato di messaggio per inviare dates, times o datetimes, ad esempio in risposta a un messaggio dinamico con un'interazione di tipo ``input_date``.
Formato del Payload
^^^^^^^^^^^^^^^^^^^
.. list-table::
:header-rows: 1
:widths: 1, 1, 5
* - Key
- Value
- Description
* - value
- String
- Rappresentazione testuale dei dati temporali, secondo lo standard `ISO8601`_
* - dateType
- String
- Tipi di valori inviati, quelli permessi sono: : ``date``, ``datetime``, ``time``,
``date_range``, ``datetime_range``, ``time_range``"
Value encoding
^^^^^^^^^^^^^^
`ISO8601`_ definisce diversi formati accettabili per ciascun profilo, attualmente utilizziamo questo sottoinsieme:
.. list-table::
:header-rows: 1
:widths: auto
* - Profile (``dateType``)
- Format
- Example
* - date
- YYYY-MM-DD
- 2019-01-09
* - time
- hh:mm:ss
- 18:59:36
* - datetime
- YYYY-MM-DDThh:mm:ss.sssZ
- 2019-01-01T18:59:36.000Z
* - date_range
- YYYY-MM-DD/YYYY-MM-DD
- 2019-01-01/2019-01-31
* - time_range
- hh:mm:ss/hh:mm:ss
- 08:00:00/18:00:00
* - datetime_range
- YYYY-MM-DDThh:mm:ssZ/YYYY-MM-DDThh:mm:ss
- 2019-01-01T08:00:00Z/2019-01-31T18:00:00Z
I millisecondi (``.sss``) nei componenti temporali sono facoltativi.
Nota che spetta al mittente convertire il valore fornito dall'utente,
che può essere in qualsiasi fuso orario, nel valore UTC equivalente
.. _ISO8601: https://en.wikipedia.org/wiki/ISO_8601
Esempio
^^^^^^^
.. code-block:: xml
9e036646-48a9-477d-a165-6feaea487c76
{
"arguments": {
"value": "2019-10-04T12:55:15.426Z",
"dateType": "datetime"
},
"chat_type": "chat",
"creation_date": "2024-10-14T17:54:40.8070000Z",
"domain": "chat",
"identifier": "0b6685ba-7118-4a1d-84ba-138f328ec54e-211610540337024",
"language": "eng",
"type": "chat_date",
"version": "1.0"
}