Tutorial: Arbeiten mit Datumsangaben und Timestamps bei Schnittstellen und API-Integrationen

Wer sich im digitalen Raum mit APIs und Schnittstellen bewegt, muss gut mit Daten jonglieren können. Analytics Reports, Bestandslisten für den Onlineshop oder Exports von Bestellungen für die externe Warenwirtschaft. In den meisten Datasheets sind Angaben zum Datum vorhanden. Nicht selten muss oder soll dieses für die weitere Verarbeitung oder Präsentation in ein anderes Format umgewandelt werden z.B. von yyyy-MM-dd zu dd.MM.yyyy. Oder Sie müssen mit einem Datum rechnen, beispielsweise um das Datum des Vortags oder Anfang / Ende des Monats zu ermitteln.

Wie Sie in Synesty Angaben zum Datum in ein anderes Format umwandeln, zeigen wir nachfolgend anhand verschiedener Fälle auf.

Umwandeln von Timestamps in lesbare Datumsangaben

Häufig stehen Datumswerte nur als Linux-Timestamp in Sekunden oder Millisekunden zur Verfügung. Über die Datumsfunktion oder mit Freemarker-Skripts können Sie die Timestamps in ein Datumsformat Ihrer Wahl umwandeln.

Beispiel:

• Quellwert: 1419338700
• Zielwert: 23.12.2014

Oder sie möchten ein lesbares Datum aus dem US-Format in das deutsche Format umwandeln z.B:

• Quellwert: 2017-11-27T14:49:48.000+01:00
• Zielwert: 27.11.2017 14:49

In unserem Cookbook Wie formatiere ich ein Datum (date) als Timestamp und anderen Formaten? zeigen wir verschiedene Wege um Zeitstempel in lesbare Datumsangaben und zurück umzuwandeln.

Mit Datumsangaben rechnen

Oft reicht die Angabe des aktuellen Datums nicht aus, sondern man möchte ein in Relation dazu festgesetztes Zeitfenster benennen. Beispielsweise dann, wenn man einen Dateinamen erzeugen möchte, der das Datum vom Vortag beinhaltet. Für solche Fälle gibt es die Template-Funktion “datecalc”. Mit dieser Funktion kann man Tage, Wochen, Monate oder Jahre von einem Referenzdatum subtrahieren oder addieren (z.B. heute plus vier Wochen). Eingesetzt werden kann diese Funktion beispielsweise in einem Text HTML Writer Step oder direkt im Mapper.

Wie Sie diese nutzen, um mit einem Datum zu rechnen, zeigen wir Ihnen in unserem Cookbook Wie kann man mit einem Datum rechnen? (z.B. Wie erzeuge ich das Datum von gestern?

Anhand der Kalenderwoche das Datum eines bestimmten Tages ermitteln

Uns erreichte eine interessante Anforderung eines unserer Kunden, welcher über Synesty eine Kalenderwochenangabe in das Datum des Montags der jeweiligen KW umwandeln wollte. Auch solche spezifischen Anforderungen sind mit einem kleinen Freemarker-Skript einfach umsetzbar. Angaben, die für die Umsetzung relevant sind, sind die Jahreszahl und die genaue Woche.

Unser Cookbook Kalenderwoche in Datum des Montags umwandeln zeigt im Detail, wie das geht.

Prüfen ob ein Datum im Bereich zwischen Datum A und Datum B liegt

Eine Anforderung eines anderen Kunden war, zu prüfen ob ein Datum im Bereich zwischen einem Start- und Enddatum liegt. Damit diese Anforderung auch einfach mit einem kleinen Skript lösbar ist, wurde die neue Template-Funktion isDateBetween eingebaut.

Wie Sie funktioniert kann in folgendem Cookbook nachgelesen werden: Wie prüfe ich ob ein Datum im Bereich zwischen Datum A und Datum B liegt?

Fazit

Wenn Sie in Synesty das Datum formatieren wollen, um die Daten weiterzuverarbeiten oder auch einfach nur anders darzustellen, haben Sie verschiedene Möglichkeiten, dies zu tun. Sie können das Datum beispielsweise mit Hilfe eines Freemarker-Ausdrucks als Timestamp formatieren. Umgekehrt ist es auch möglich, einen Linux-Timestamp (Sekunden oder Millisekunden) in ein lesbares Datum zu verwandeln. Dies kann über die Datumsfunktion oder das Freemarker-Skript gesteuert werden. Innerhalb von Synesty können Sie außerdem mit einem Datum rechnen, um somit beispielsweise Dateinamen zu erzeugen, die den Vortag zum Zeitpunkt x beinhalten.

Dank der jeweiligen Beispiele haben Sie nun einige Möglichkeiten kennengelernt, mit denen Sie Ihre Daten so formatieren können, wie Sie es sich wünschen. Bei weiteren Fragen scheuen Sie sich nicht, unseren Support zu kontaktieren.

Das ganze können Sie einige Datumsfunktionen gern hier sofort ausprobieren. Dort sehen Sie eine Tabelle wie diese: