Skip to content

Datum & Uhrzeit

EFA akzeptiert Datum und Uhrzeit request-übergreifend über dasselbe Parameterset. Alle Felder sind optional — fehlen sie, nimmt der Server seine aktuelle Zeit. Ausgabewerte im JSON sind immer UTC (ISO 8601).

Datums-Parameter

ParameterFormatBeschreibung
itdDateYYYYMMDD oder YYMMDDVollständiges Datum
itdDateDayD oder DDnur Tag
itdDateMonthM oder MMnur Monat
itdDateYearYY oder YYYYnur Jahr
itdDateYearMonthYYYYMMJahr + Monat
itdDateDayMonthYearDDMMYYYY (Trenner optional, Jahr vierstellig)Tag + Monat + Jahr

Zeit-Parameter

ParameterFormatBeschreibung
itdTimeHHMM | HH:MM | HH.MM | MM | HHMMa | HHMMh | HHMMpUhrzeit in verschiedenen Varianten (a=am, p=pm, h=24h)
itdTimeHourH oder HHnur Stunden
itdTimeMinuteM oder MMnur Minuten
itdTimeAMPMam (Default) | pm12-Stunden-Indikator

Zeitoffset

ParameterEinheitBeschreibung
timeOffsetMinuten (vorzeichenbehaftet)Wird zur Serverzeit addiert

Interpretation

  • Zeitzone: Eingaben gelten lokal (Europe/Berlin), Sommer-/Winterzeitwechsel berücksichtigt der Server.
  • Default-Verhalten: Fehlen alle Datumsfelder, gilt „heute". Fehlen alle Zeitfelder, gilt „jetzt".
  • Partial-Formate kombinierbar: itdDateYear=2025&itdDateMonth=01&itdDateDay=25 entspricht itdDate=20250125.

Request-spezifische Varianten

Einzelne Endpoints ergänzen Suffixe:

  • Trip: itdTripDateTimeDepArr = dep | arr legt fest, ob Datum/Uhrzeit für Abfahrt oder Ankunft gelten.
  • DM / DMTTP: itdDateTimeDepArr = dep | arr | firstService | lastService.
  • PS: eigene Suffix-Familie itdTime_<usagePS> mit <usagePS>{arrFrom, arrTo, depFrom, depTo} — siehe PS-Request.

Beispiele

itdDate=20250125&itdTime=0815
itdDateYear=2025&itdDateMonth=01&itdDateDay=25&itdTimeHour=8&itdTimeMinute=15
itdTime=0815p&itdTimeAMPM=pm
timeOffset=30