Entidad precompilada DatetimeV2 para una aplicación de LUIS

Artículo
09/01/2024

Importante

LUIS se retirará el 1 de octubre de 2025. Además, a partir del 1 de abril de 2023, ya no se podrán crear recursos de este servicio. Se recomienda migrar las aplicaciones de LUIS al reconocimiento del lenguaje conversacional para aprovechar el soporte continuo del producto y las capacidades multilingües.

La entidad precompilada datetimeV2 extrae los valores de fecha y hora. Estos valores se resuelven en un formato estandarizado para que los programas de cliente los consuman. Cuando una expresión tiene una fecha u hora que no está completa, LUIS incluye los valores pasados y futuros en la respuesta de punto de conexión. Dado que esta entidad ya está entrenada, no es necesario agregar expresiones de ejemplo que contengan la entidad datetimeV2 para las intenciones de la aplicación.

Tipos de datetimeV2

DatetimeV2 se administra desde el repositorio Recognizers-text de GitHub.

Ejemplo de JSON

A continuación se muestra la siguiente expresión y su respuesta JSON parcial.

8am on may 2nd 2019

"entities": {
    "datetimeV2": [
        {
            "type": "datetime",
            "values": [
                {
                    "timex": "2019-05-02T08",
                    "resolution": [
                        {
                            "value": "2019-05-02 08:00:00"
                        }
                    ]
                }
            ]
        }
    ]
}


"entities": {
    "datetimeV2": [
        {
            "type": "datetime",
            "values": [
                {
                    "timex": "2019-05-02T08",
                    "resolution": [
                        {
                            "value": "2019-05-02 08:00:00"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.datetime",
                "text": "8am on may 2nd 2019",
                "startIndex": 0,
                "length": 19,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

"entities": [
  {
    "entity": "8am on may 2nd 2019",
    "type": "builtin.datetimeV2.datetime",
    "startIndex": 0,
    "endIndex": 18,
    "resolution": {
      "values": [
        {
          "timex": "2019-05-02T08",
          "type": "datetime",
          "value": "2019-05-02 08:00:00"
        }
      ]
    }
  }
]

Nombre de propiedad	Tipo de propiedad y descripción
Entidad	cadena: texto extraído de la expresión con el tipo de fecha, hora, intervalo de fechas o el intervalo de tiempo.
type	cadena: uno de los subtipos de datetimeV2
startIndex	entero: índice en la expresión en la que comienza la entidad.
endIndex	entero: índice en la expresión en la que termina la entidad.
resolución	Tiene una matriz `values` con uno, dos o cuatro valores de resolución.
end	El valor final de un intervalo de tiempo o fechas, en el mismo formato que `value`. Solo se utiliza si `type` es `daterange`, `timerange` o `datetimerange`.

Subtipos de datetimeV2

La entidad precompilada datetimeV2 tiene los siguientes subtipos. Se proporcionan ejemplos de cada uno en la siguiente tabla:

date
time
daterange
timerange
datetimerange

Valores de resolución

La matriz tiene un elemento si la fecha u hora de la expresión se especifica completamente y no es ambigua.
Si el valor de datetimeV2 es ambiguo, la matriz tiene dos elementos. La ambigüedad existe cuando falta un año, una hora o un intervalo de tiempo concretos. Consulte la sección Fechas ambiguas para obtener ejemplos. Cuando la hora es ambigua en cuanto a a. m. o p. m., se incluyen ambos valores.
Si la expresión tiene dos elementos con ambigüedad, la matriz tiene cuatro elementos. Esta ambigüedad incluye elementos que tienen:
- Una fecha o un intervalo de fechas que es ambiguo en cuanto al año
- Un tiempo o intervalo de tiempo ambiguo en cuanto a a. m. o p. m. Por ejemplo, 3:00 del 3 de abril.

Cada elemento de la matriz values puede tener los siguientes campos:

Nombre de propiedad	Descripción de la propiedad
timex	Hora, fecha o intervalo de fechas que se expresa en formato TIMEX según el estándar ISO 8601 y los atributos de TIMEX3 para la anotación con el idioma de TimeML.
mod	Término usado para describir cómo utilizar el valor, como `before`, `after`.
type	El subtipo, que puede ser uno de los siguientes elementos: `datetime`, `date`, `time`, `daterange`, `timerange`, `datetimerange`, `duration`, `set`.
value	Opcional. Objeto datetime con el formato aaaa-MM-dd (fecha), HH:mm:ss (hora) o aaaa-MM-dd HH:mm:ss (fecha y hora). Si `type` es `duration`, el valor es el número de segundos (duración) Solo se utiliza si `type` es `datetime` o `date`, `time` o "duración".

Valores de fecha válidos

La entidad datetimeV2 admite fechas entre los siguientes intervalos:

Min	Max
1 de enero de 1900	31 de diciembre de 2099

Fechas ambiguas

Si la fecha puede estar en el pasado o futuro, LUIS proporciona ambos valores. Este sería el caso de una expresión que incluyera el mes y la fecha sin el año.

Por ejemplo, dada la siguiente expresión:

May 2nd

Si hoy es 3 de mayo de 2017, LUIS proporciona "2017-05-02" y "2018-05-02" como valores.
Si hoy es 1 de mayo de 2017, LUIS proporciona "2016-05-02" y "2017-05-02" como valores.

En el siguiente ejemplo, se muestra la resolución de la entidad "may 2nd". En esta resolución, se da por supuesto que la fecha de hoy es una fecha comprendida entre el 2 de mayo de 2017 y el 1 de mayo de 2018. Los campos con X en el campo timex forman parte de la fecha i no se especifican explícitamente en la expresión.

Ejemplo de resolución de fecha

A continuación se muestra la siguiente expresión y su respuesta JSON parcial.

May 2nd

"entities": {
    "datetimeV2": [
        {
            "type": "date",
            "values": [
                {
                    "timex": "XXXX-05-02",
                    "resolution": [
                        {
                            "value": "2019-05-02"
                        },
                        {
                            "value": "2020-05-02"
                        }
                    ]
                }
            ]
        }
    ]
}

"entities": {
    "datetimeV2": [
        {
            "type": "date",
            "values": [
                {
                    "timex": "XXXX-05-02",
                    "resolution": [
                        {
                            "value": "2019-05-02"
                        },
                        {
                            "value": "2020-05-02"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.date",
                "text": "May 2nd",
                "startIndex": 0,
                "length": 7,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

  "entities": [
    {
      "entity": "may 2nd",
      "type": "builtin.datetimeV2.date",
      "startIndex": 0,
      "endIndex": 6,
      "resolution": {
        "values": [
          {
            "timex": "XXXX-05-02",
            "type": "date",
            "value": "2019-05-02"
          },
          {
            "timex": "XXXX-05-02",
            "type": "date",
            "value": "2020-05-02"
          }
        ]
      }
    }
  ]

Ejemplos de resolución de intervalo de fechas para una fecha numérica

La entidad datetimeV2 extrae los intervalos de fecha y hora. Los campos start y end especifican el principio y al final del intervalo. Para la expresión May 2nd to May 5th, LUIS proporciona valores de daterange para el año actual y el próximo año. En el campo timex, los valores XXXX indican la ambigüedad del año. P3D indica que el período de tiempo es de tres días de duración.

A continuación se muestra la siguiente expresión y su respuesta JSON parcial.

May 2nd to May 5th


"entities": {
    "datetimeV2": [
        {
            "type": "daterange",
            "values": [
                {
                    "timex": "(XXXX-05-02,XXXX-05-05,P3D)",
                    "resolution": [
                        {
                            "start": "2019-05-02",
                            "end": "2019-05-05"
                        },
                        {
                            "start": "2020-05-02",
                            "end": "2020-05-05"
                        }
                    ]
                }
            ]
        }
    ]
}


"entities": {
    "datetimeV2": [
        {
            "type": "daterange",
            "values": [
                {
                    "timex": "(XXXX-05-02,XXXX-05-05,P3D)",
                    "resolution": [
                        {
                            "start": "2019-05-02",
                            "end": "2019-05-05"
                        },
                        {
                            "start": "2020-05-02",
                            "end": "2020-05-05"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.daterange",
                "text": "May 2nd to May 5th",
                "startIndex": 0,
                "length": 18,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

"entities": [
    {
      "entity": "may 2nd to may 5th",
      "type": "builtin.datetimeV2.daterange",
      "startIndex": 0,
      "endIndex": 17,
      "resolution": {
        "values": [
          {
            "timex": "(XXXX-05-02,XXXX-05-05,P3D)",
            "type": "daterange",
            "start": "2019-05-02",
            "end": "2019-05-05"
          }
        ]
      }
    }
  ]

Ejemplos de resolución de intervalo de fechas para un día de la semana

En el siguiente ejemplo, se muestra cómo LUIS usa la entidad datetimeV2 para resolver la expresión Tuesday to Thursday. En este ejemplo, se supone que la fecha actual es el 19 de junio. LUIS incluye valores daterange para los dos intervalos de fechas que preceden y siguen la fecha actual.

A continuación se muestra la siguiente expresión y su respuesta JSON parcial.

Tuesday to Thursday

"entities": {
    "datetimeV2": [
        {
            "type": "daterange",
            "values": [
                {
                    "timex": "(XXXX-WXX-2,XXXX-WXX-4,P2D)",
                    "resolution": [
                        {
                            "start": "2019-10-08",
                            "end": "2019-10-10"
                        },
                        {
                            "start": "2019-10-15",
                            "end": "2019-10-17"
                        }
                    ]
                }
            ]
        }
    ]
}

"entities": {
    "datetimeV2": [
        {
            "type": "daterange",
            "values": [
                {
                    "timex": "(XXXX-WXX-2,XXXX-WXX-4,P2D)",
                    "resolution": [
                        {
                            "start": "2019-10-08",
                            "end": "2019-10-10"
                        },
                        {
                            "start": "2019-10-15",
                            "end": "2019-10-17"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.daterange",
                "text": "Tuesday to Thursday",
                "startIndex": 0,
                "length": 19,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

  "entities": [
    {
      "entity": "tuesday to thursday",
      "type": "builtin.datetimeV2.daterange",
      "startIndex": 0,
      "endIndex": 19,
      "resolution": {
        "values": [
          {
            "timex": "(XXXX-WXX-2,XXXX-WXX-4,P2D)",
            "type": "daterange",
            "start": "2019-04-30",
            "end": "2019-05-02"
          }
        ]
      }
    }
  ]

Hora ambigua

La matriz de valores tiene dos elementos de tiempo si la hora o el intervalo de tiempo son ambiguos. Cuando hay una hora ambigua, los valores tienen tanto las horas a. m. como p. m.

Ejemplo de resolución de intervalo de tiempo

La respuesta JSON DatetimeV2 ha cambiado en la API V3. En el siguiente ejemplo, se muestra cómo LUIS utiliza la entidad datetimeV2 para resolver la expresión que tiene el intervalo de tiempo.

Cambios de la API V2:

La propiedad datetimeV2.timex.type ya no se devuelve la propiedad porque se devuelve en el nivel primario, datetimev2.type.
La propiedad datetimeV2.value se llama ahora datetimeV2.timex.

A continuación se muestra la siguiente expresión y su respuesta JSON parcial.

from 6pm to 7pm

El siguiente JSON es con el parámetro verbose establecido en false:


"entities": {
    "datetimeV2": [
        {
            "type": "timerange",
            "values": [
                {
                    "timex": "(T18,T19,PT1H)",
                    "resolution": [
                        {
                            "start": "18:00:00",
                            "end": "19:00:00"
                        }
                    ]
                }
            ]
        }
    ]
}

El siguiente JSON es con el parámetro verbose establecido en true:


"entities": {
    "datetimeV2": [
        {
            "type": "timerange",
            "values": [
                {
                    "timex": "(T18,T19,PT1H)",
                    "resolution": [
                        {
                            "start": "18:00:00",
                            "end": "19:00:00"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.timerange",
                "text": "from 6pm to 7pm",
                "startIndex": 0,
                "length": 15,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

  "entities": [
    {
      "entity": "6pm to 7pm",
      "type": "builtin.datetimeV2.timerange",
      "startIndex": 0,
      "endIndex": 9,
      "resolution": {
        "values": [
          {
            "timex": "(T18,T19,PT1H)",
            "type": "timerange",
            "start": "18:00:00",
            "end": "19:00:00"
          }
        ]
      }
    }
  ]

Ejemplo de resolución de tiempo

A continuación se muestra la siguiente expresión y su respuesta JSON parcial.

8am

"entities": {
    "datetimeV2": [
        {
            "type": "time",
            "values": [
                {
                    "timex": "T08",
                    "resolution": [
                        {
                            "value": "08:00:00"
                        }
                    ]
                }
            ]
        }
    ]
}

"entities": {
    "datetimeV2": [
        {
            "type": "time",
            "values": [
                {
                    "timex": "T08",
                    "resolution": [
                        {
                            "value": "08:00:00"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.time",
                "text": "8am",
                "startIndex": 0,
                "length": 3,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

"entities": [
  {
    "entity": "8am",
    "type": "builtin.datetimeV2.time",
    "startIndex": 0,
    "endIndex": 2,
    "resolution": {
      "values": [
        {
          "timex": "T08",
          "type": "time",
          "value": "08:00:00"
        }
      ]
    }
  }
]

Intervalo de tiempo precompilado en desuso

La entidad precompilada datetime está en desuso y se reemplaza por datetimeV2.

Para reemplazar datetime por datetimeV2 en la aplicación de LUIS, complete los pasos siguientes:

Abra el panel Entities (Entidades) de la interfaz web de LUIS.
Elimine la entidad precompilada datetime.
Seleccione Agregar entidad creada previamente
Seleccione datetimeV2 y haga clic en Save (Guardar).

Pasos siguientes

Obtenga información acerca de las entidades dimensión, correo electrónico y número.

Compartir a través de

Entidad precompilada DatetimeV2 para una aplicación de LUIS

Tipos de datetimeV2

Ejemplo de JSON

Subtipos de datetimeV2

Valores de resolución

Valores de fecha válidos

Fechas ambiguas

Ejemplo de resolución de fecha

Ejemplos de resolución de intervalo de fechas para una fecha numérica

Ejemplos de resolución de intervalo de fechas para un día de la semana

Hora ambigua

Ejemplo de resolución de intervalo de tiempo

Ejemplo de resolución de tiempo

Intervalo de tiempo precompilado en desuso

Pasos siguientes

Recursos adicionales