How to use it

Añotador takes a text or a json as an input and returns it as a JSON or a TimeML document.

The system only needs a text, but you can also provide the date to anchor (this means that if it finds “tomorrow” with “2019-10-20”, it will consider that its value is “2019-10-21”; if not provided, it considers the present day as anchor) and the language (default is Spanish). The system annotates text following the TimeML standard, this is, using some “TIMEX3” tags like in the following examples:

<TIMEX3 tid="t1" type="DATE" value="2019-04-09">Hoy</TIMEX3> es <TIMEX3 tid="t2" type="DATE" value="2019-10-03">3 de octubre</TIMEX3>

Hoy es 3 de octubre

Trabajamos <TIMEX3 tid="t1" type="SET" value="P1W" freq="02X">dos veces a la semana</TIMEX3>

Trabajamos dos veces a la semana


<TIMEX3 tid="t1" type="DATE" value="2019-04-09">Today</TIMEX3> is <TIMEX3 tid="t2" type="DATE" value="2019-10-03">3 of October</TIMEX3>

Today is 3 of October

We work <TIMEX3 tid="t1" type="SET" value="P1W" freq="02X">twice a week</TIMEX3>

We work twice a week

Probably the most important part for you is the field “value”, that appears in all kinds of temporal expression and follows the ISO 8601 standard. There are also other fields, like “freq” when talking about repetitive events, that just appear for some temporal expressions (in the example, “twice a week”). For now, the system detects dates (“May 10”), times (“at 2pm”, “two o’clock”…), sets (such as “monthly”, “once a week”, for instance) and durations (“two days and five hours”), and I plan to eventually add intervals. You can use the demo for a more intuitive first annotation.

Añotador is written in Java and available in several ways, detailed below. Please report any problem or question you have via GitHub issues or directly by email to

Where to find it


Añotador is available in GitHub as a Java Maven project. To use it, just clone the repository and exececute as follows:

git clone
mvn clean install

Go to GitHub


Añotador can be deployed as a Docker image. Please go the GitHub to further information.

Go to GitHub


There is a webapp of Añotador were you can send a request. You can also the following Postman collection with requests in Spanish and English as a first example.

Go to Postman collection


Añotador will be soon available as a Swagger Rest service!


Añotador will be soon available as a Maven dependency library!