Skip to content
HALOWERK

Textwerk

date expression de

Combines chrono-node 2.10 (German parser: weekdays, relative days, times, explicit dates, ranges) with own rules for what chrono does not cover: quarters (Q3, 3. Quartal), half years, ISO calendar weeks, relative weeks/months/years, Anfang/Mitte/Ende of months per § 192 BGB (1st, 15th, last day) and of other periods (first, middle, last day), weekends, "kommenden Freitag", day.month without year, month and year ends, and holidays (Easter by the anonymous Gregorian algorithm). Missing years.

POST https://text.halowerk.com/v1/date-expression-de

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYesGerman text containing one or more date expressions.
referencestringNoReference time (ISO 8601). Default: now.
timezonestringNoIANA time zone, e.g. Europe/Berlin, Europe/Vienna, UTC.
preferstringNoHow to choose a year or week when the text does not say.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "German text containing one or more date expressions."
    },
    "reference": {
      "type": "string",
      "format": "date-time",
      "description": "Reference time (ISO 8601). Default: now."
    },
    "timezone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "default": "Europe/Berlin",
      "description": "IANA time zone, e.g. Europe/Berlin, Europe/Vienna, UTC."
    },
    "prefer": {
      "type": "string",
      "enum": [
        "future",
        "past",
        "nearest"
      ],
      "default": "future",
      "description": "How to choose a year or week when the text does not say."
    }
  }
}

Open original schema

Published input example

{
  "text": "Bitte bis Ende Q3 liefern, Abstimmung nächsten Dienstag um 14 Uhr.",
  "reference": "2026-11-01T10:00:00+01:00",
  "timezone": "Europe/Berlin"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →