Vooraf gedefinieerde datum/tijdV2-entiteit voor een LUIS-app

Belangrijk

LUIS wordt op 1 oktober 2025 buiten gebruik gesteld en vanaf 1 april 2023 kunt u geen nieuwe LUIS-resources maken. We raden u aan uw LUIS-toepassingen te migreren naar gesprekstaalbegrip om te profiteren van continue productondersteuning en meertalige mogelijkheden.

Met de vooraf gedefinieerde datum/tijd-entiteit datetimeV2 worden datum- en tijdwaarden geëxtraheerd. Deze waarden worden omgezet in een gestandaardiseerde indeling die clientprogramma's kunnen gebruiken. Wanneer een uiting een datum of tijd heeft die niet is voltooid, bevat LUIS zowel eerdere als toekomstige waarden in het eindpuntantwoord. Omdat deze entiteit al is getraind, hoeft u geen voorbeelduitingen met datetimeV2 toe te voegen aan de intenties van de toepassing.

Typen datum/tijdV2

DatetimeV2 wordt beheerd vanuit de GitHub-opslagplaats Recognizers-text .

Voorbeeld van JSON

Hieronder ziet u de volgende utterance en het gedeeltelijke JSON-antwoord.

8am on may 2nd 2019

V3-antwoord

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

Uitgebreid V3-antwoord

"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"
                ]
            }
        ]
    }
}

V2-antwoord

"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"
        }
      ]
    }
  }
]

Eigenschapsnaam	Eigenschapstype en beschrijving
Entity	tekenreeks : tekst geëxtraheerd uit de uiting met het type datum, tijd, datumbereik of tijdsbereik.
type	tekenreeks - een van de subtypen van datum/tijdV2
startIndex	int : de index in de utterance waarop de entiteit begint.
endIndex	int: de index in de uiting waarop de entiteit eindigt .
resolutie	Heeft een values matrix met één, twee of vier waarden voor resolutie.
end	De eindwaarde van een tijd, of datumbereik, in dezelfde notatie als value. Alleen gebruikt als type is daterange, timerangeof datetimerange

Subtypen van datum/tijdV2

De vooraf samengestelde entiteit datetimeV2 heeft de volgende subtypen en er worden voorbeelden gegeven in de volgende tabel:

• date
• time
• daterange
• timerange
• datetimerange

Waarden van resolutie

• De matrix heeft één element als de datum of tijd in de uiting volledig is opgegeven en ondubbelzinnig is.
• De matrix heeft twee elementen als de datum/tijdV2-waarde dubbelzinnig is. Dubbelzinnigheid omvat een gebrek aan specifieke jaren, tijd of tijdsbereik. Zie Dubbelzinnige datums voor voorbeelden. Wanneer de tijd dubbelzinnig is voor A.M. of P.M., worden beide waarden opgenomen.
• De matrix heeft vier elementen als de utterance twee elementen met dubbelzinnigheid heeft. Deze dubbelzinnigheid bevat elementen met:
  • Een datum- of datumbereik dat niet eenduidig is over het jaar
  • Een tijds- of tijdsbereik dat niet eenduidig is over A.M. of P.M. Bijvoorbeeld 3:00 april 3 april.

Elk element van de values matrix kan de volgende velden hebben:

Eigenschapsnaam	Beschrijving eigenschap
Timex	tijd, datum of datumbereik uitgedrukt in TIMEX-indeling die volgt op de ISO 8601-standaard en de TIMEX3-kenmerken voor aantekeningen met behulp van de TimeML-taal.
mod	term die wordt gebruikt om te beschrijven hoe de waarde wordt gebruikt, zoals before, after.
type	Het subtype, dat een van de volgende items kan zijn: datetime, , date, daterangetime, timerange, , datetimerange, , duration. set
waarde	Optioneel. Een datum/tijd-object in de notatie jjjj-MM-dd (datum), UU:mm:ss (tijd) jjjj-MM-dd HH:mm:ss (datum/tijd). Als type dat het is duration, is de waarde het aantal seconden (duur) Alleen gebruikt als type is datetime of date, timeof 'duur.

Geldige datumwaarden

De datum/tijdV2 ondersteunt datums tussen de volgende bereiken:

Min.	Max.
1 januari 1900	31 december 2099

Dubbelzinnige datums

Als de datum zich in het verleden of de toekomst kan bevinden, biedt LUIS beide waarden. Een voorbeeld is een uiting die de maand en datum zonder het jaar bevat.

Bijvoorbeeld, op basis van de volgende utterance:

May 2nd

• Als de datum van vandaag 3 mei 2017 is, biedt LUIS zowel '2017-05-02' als '2018-05-02' als waarden.
• Wanneer de datum van vandaag 1 mei 2017 is, biedt LUIS zowel '2016-05-02' als '2017-05-02' als waarden.

In het volgende voorbeeld ziet u de oplossing van de entiteit 'mei 2nd'. In deze resolutie wordt ervan uitgegaan dat de datum van vandaag een datum is tussen 2 mei 2017 en 1 mei 2018. Velden met X in het timex veld zijn onderdelen van de datum die niet expliciet zijn opgegeven in de utterance.

Voorbeeld van datumomzetting

Hieronder ziet u de volgende utterance en het gedeeltelijke JSON-antwoord.

May 2nd

V3-antwoord

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

Uitgebreid V3-antwoord

"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"
                ]
            }
        ]
    }
}

V2-antwoord

  "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"
          }
        ]
      }
    }
  ]

Voorbeelden van datumbereikomzetting voor numerieke datum

De datetimeV2 entiteit extraheert datum- en tijdsbereiken. De start velden geven end het begin en einde van het bereik op. Voor de uiting May 2nd to May 5thbiedt LUIS datumbereikwaarden voor zowel het huidige jaar als het volgende jaar. In het timex veld geven de XXXX waarden de dubbelzinnigheid van het jaar aan. P3D geeft aan dat de periode drie dagen lang is.

Hieronder ziet u de volgende utterance en het gedeeltelijke JSON-antwoord.

May 2nd to May 5th

V3-antwoord

"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"
                        }
                    ]
                }
            ]
        }
    ]
}

Uitgebreid V3-antwoord

"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"
                ]
            }
        ]
    }
}

V2-antwoord

"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"
          }
        ]
      }
    }
  ]

Voorbeelden van datumbereikomzetting voor dag van de week

In het volgende voorbeeld ziet u hoe LUIS datetimeV2 gebruikt om de uiting Tuesday to Thursdayop te lossen. In dit voorbeeld is de huidige datum 19 juni. LUIS bevat waarden voor datumbereiken voor beide datumbereiken die voorafgaan en de huidige datum volgen.

Hieronder ziet u de volgende utterance en het gedeeltelijke JSON-antwoord.

Tuesday to Thursday

V3-antwoord

"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"
                        }
                    ]
                }
            ]
        }
    ]
}

Uitgebreid V3-antwoord

"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"
                ]
            }
        ]
    }
}

V2-antwoord

  "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"
          }
        ]
      }
    }
  ]

Dubbelzinnige tijd

De waardenmatrix heeft twee tijdelementen als de tijd of het tijdsbereik niet eenduidig is. Wanneer er sprake is van een dubbelzinnige tijd, hebben waarden zowel de A.M. als P.M. keer.

Voorbeeld van tijdsbereikomzetting

Het JSON-antwoord datetimeV2 is gewijzigd in de API V3. In het volgende voorbeeld ziet u hoe LUIS datetimeV2 gebruikt om de uiting met een tijdsbereik op te lossen.

Wijzigingen van API V2:

• datetimeV2.timex.type eigenschap wordt niet meer geretourneerd omdat deze wordt geretourneerd op het bovenliggende niveau, datetimev2.type.
• De naam van de datetimeV2.value eigenschap is gewijzigd in datetimeV2.timex.

Hieronder ziet u de volgende utterance en het gedeeltelijke JSON-antwoord.

from 6pm to 7pm

V3-antwoord

De volgende JSON is met de verbose parameter ingesteld op false:

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

Uitgebreid V3-antwoord

De volgende JSON is met de verbose parameter ingesteld op 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"
                ]
            }
        ]
    }
}

V2-antwoord

  "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"
          }
        ]
      }
    }
  ]

Voorbeeld van tijdomzetting

Hieronder ziet u de volgende utterance en het gedeeltelijke JSON-antwoord.

8am

V3-antwoord

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

Uitgebreid V3-antwoord

"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"
                ]
            }
        ]
    }
}

V2-antwoord

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

Afgeschafte vooraf gemaakte datum/tijd

De datetime vooraf gemaakte entiteit is afgeschaft en vervangen door datetimeV2.

Voer de volgende stappen uit om te vervangen door datetime datetimeV2 in uw LUIS-app:

1. Open het deelvenster Entiteiten van de LUIS-webinterface.
2. Verwijder de vooraf gemaakte datum/tijd-entiteit .
3. Vooraf gedefinieerde entiteit toevoegen selecteren
4. Selecteer datetimeV2 en klik op Opslaan.

Volgende stappen

Meer informatie over de dimensie, e-mailentiteiten en het nummer.