How to use it

Añotador takes a json as an input and returns it as a JSON or a TimeML document. There are two different domains to choose: "General" (or Standard), that follows the TimeML standard, and "Legal", that includes specific domain considerations and tags, such as finding INTERVALS or normalizing differently some temporal expressions.

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 in the General version of Añotador. 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”). In the "Legal" mode Añotador also finds 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 mnavas(at)fi(dot)upm(dot)es

If you want to use Añotador, please cite the paper Annotador: a temporal tagger for Spanish.

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 Go to Code Documentation


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

Go to GitHub


There is a webapp of Añotador where you can send a request. You can also check the following Postman collection with requests in Spanish and English for 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!