Downloads erklärt

Sechs Dateiformate, ein Datensatz. Welches Format wofür gedacht ist, wie es aufgebaut ist, und wie viel man davon pro Stunde herunterladen darf.

Zahlen und Einheiten

Eins gilt für alle Formate, deshalb steht es hier vorne: der Zahlenwert und seine Einheit sind getrennt. In den Spalten Ist, Prognose und Vorherig steht eine reine Zahl (0.3), die Einheit der Kennzahl steht einmal daneben in der Spalte Einheit (%, K, M, B, T oder leer).

Grund: die Einheit ist eine Eigenschaft der Kennzahl, nicht der einzelnen Zahl. Steht sie als Text mitten im Wert (0.3%), muss jedes Programm sie erst wieder abschneiden, bevor es rechnen kann — und jedes tut das anders. Getrennt lässt sich beides sofort verwenden: die Zahl zum Rechnen, die Einheit zum Beschriften.

K/M/B/T sind Größenfaktoren (Tausend, Million, Milliarde, Billion): 737 mit Einheit K bedeutet 737 000. % ist dagegen eine reine Beschriftung ohne Faktor. Wer nicht selbst multiplizieren will, nimmt in XLSX und im JSON-API die Felder ist_zahl/prognose_zahl/vorherig_zahl — dort ist der Faktor schon eingerechnet.

Die einzige Ausnahme ist ICS: ein Kalendereintrag ist Text für Menschen, dort stehen Wert und Einheit zusammen in einem Satz („Prognose: 0.3%“). Auf der Kalenderseite selbst ebenso — in der Tabelle und im Detail-Fenster wird die Einheit immer angehängt.

Einzelne Kennzahlen tragen ihre Größenangabe noch im Wert selbst (196K in derselben Spalte wie 206). Das sind Reihen, in denen sich zwei Quellen um den Faktor 1000 widersprechen; dort wird bewusst nichts geraten und die Spalte Einheit bleibt leer, bis der Widerspruch geklärt ist.

CSV (Excel)

CSV (Excel) herunterladen

Für den Doppelklick: direkt in Microsoft Excel öffnen, ohne den Text-Import-Assistenten durchzuklicken. Deshalb mit den Eigenheiten, die ein deutschsprachiges Excel beim Öffnen einer CSV-Datei erwartet: Semikolon statt Komma als Trennzeichen (ein normales Komma-CSV reisst bei uns sonst jede Zahlenspalte in einzelne Spalten auseinander), Dezimalkomma statt Dezimalpunkt, eine UTF-8-BOM am Dateianfang (sonst zeigt Excel Umlaute falsch an) und eine sep=;-Kopfzeile, die Excel explizit mitteilt, welches Trennzeichen gilt.

Für alles ausser Excel (Mac-Programme, Skripte, andere Tabellenkalkulationen) eher die nächste Zeile nehmen.

CSV (Standard)

CSV (Standard) herunterladen

Normales CSV nach der weit verbreiteten Konvention: Komma als Trennzeichen, Dezimalpunkt, UTF-8 ohne BOM. Passt zu Python (pandas.read_csv), R, Numbers auf dem Mac, und praktisch jedem Programm, das nicht speziell auf ein deutsches Excel Rücksicht nehmen muss. Trägt zusätzlich eine Spalte ts_utc (Unix-Zeitstempel) — für eine exakte Zeitverarbeitung ohne Rätselraten über Zeitzonen und Sommerzeit.

Excel (XLSX)

Excel (XLSX) herunterladen

Eine fertige Excel-Arbeitsmappe zum sofortigen Weiterarbeiten, kein Rohtext. Die Tabelle kommt mit eingebautem AutoFilter (die Spaltenköpfe sind in Excel selbst schon anklickbar filter- und sortierbar), fester Spaltenbreite und bedingter Formatierung: Zeilen mit hoher Wichtigkeit sind rot hinterlegt, mittlere gelb.

Obergrenze: 50 000 Zeilen. Bei einer gefilterten Auswahl bis zu dieser Grenze kein Problem; für den kompletten, ungefilterten Datensatz darüber hinaus den täglichen Vollexport nehmen (/kalender/export/voll.xlsx, siehe unten).

Numbers (Apple)

Für Numbers herunterladen (XLSX)

Das ist dieselbe XLSX-Datei wie eine Zeile höher — kein eigenes Numbers-Format. Apple Numbers öffnet XLSX-Arbeitsmappen direkt über Datei → Öffnen (oder per Doppelklick, wenn Numbers als Standard eingestellt ist); ein Umweg über einen Export ist nicht nötig. Der Knopf steht hier, weil die Frage „und für Numbers?“ sonst offen bleibt.

Beim Import kann Numbers Teile der Excel-Ausstattung weglassen (Tabellenstil, AutoFilter, bedingte Formatierung) — die Daten selbst kommen vollständig an. Wer nur die Daten will und keine Formatierung braucht, ist mit CSV (Standard) weiter oben besser bedient: Numbers liest es ohne jede Nachfrage, und Dezimalpunkt/UTF-8 passen dort.

Warum keine echte .numbers-Datei? Das Numbers-Format ist von Apple nicht offengelegt. Es zu schreiben wäre nur über eine fremde Bibliothek möglich, die das Format rückwärts nachgebaut hat — eine zusätzliche Abhängigkeit, die bei der nächsten Numbers-Version stillschweigend kaputtgehen kann, für ein Ergebnis, das Numbers auch so schon öffnet. Deshalb bewusst nicht: lieber ein Format, das dokumentiert ist und hält.

SQLite

SQLite herunterladen

Für eigene Abfragen per SQL statt per Hand durch eine Tabelle zu scrollen — eine einzelne .sqlite-Datei mit einer Tabelle termine und einer kleinen Tabelle hinweise (Datenstand, Zeilenzahl, Herkunftstext). Öffnen z. B. mit „DB Browser for SQLite“, DBeaver, oder direkt aus jeder Programmiersprache mit SQLite-Anbindung (in Python z. B. sqlite3, ohne zusätzliche Bibliothek). Eignet sich, um die Kalenderdaten mit eigenen Daten zu verknüpfen (JOIN), statt nur eine Momentaufnahme zu lesen.

NDJSON

NDJSON herunterladen

Newline Delimited JSON — jede Zeile der Datei ist ein eigenständiges JSON-Objekt, ein Termin pro Zeile. Der Unterschied zu einer normalen JSON-Datei (ein grosses Array): eine Pipeline kann Zeile für Zeile lesen und verarbeiten, ohne erst die komplette Datei in den Speicher zu laden — bei mehreren zehntausend Zeilen ein echter Unterschied. Gedacht für eigene Programme und Datenpipelines, nicht zum manuellen Anschauen.

Kalender (ICS)

Kalender (ICS) herunterladen

Zum Import in einen echten Kalender — Outlook, Apple Kalender, Google Kalender, oder jedes andere Programm, das den iCalendar-Standard (RFC 5545) versteht. Jeder Termin wird ein eigener Kalendereintrag mit Titel, Zeitpunkt und einer kurzen Beschreibung (Prognose/Vorheriger Wert).

Obergrenze: 5000 Termine. Bei einem so grossen Zeitraum lieber den Filter (Zeitraum, Währung, Wichtigkeit) vor dem Download enger fassen, statt an die Grenze zu stossen.

API und Schlüssel

Für wiederkehrenden, programmatischen Zugriff (statt einzelner Downloads) gibt es ein eigenes JSON-API mit Filter-, Sortier- und Blätter-Funktionen — siehe API-Dokumentation. Ein kostenloser API-Schlüssel hebt die Grenzen unten deutlich an (siehe Tabelle) und ist in ein paar Sekunden beantragt, keine Kreditkarte, keine Zahlung.

Regeln: nicht alles auf Vorrat laden

Die Downloads sind bewusst knapp gedrosselt, gezählt über ein rollierendes Ein-Stunden-Fenster (kein fester Uhrzeit-Reset, sondern: wie viele Anfragen in der letzten Stunde zählen wirklich). Wer versucht, „einfach mal alles“ herunterzuladen, stösst damit fast sofort an die Grenze — die Kontingente sind für gezieltes Filtern gedacht, nicht für Sammeln auf Vorrat.

Zusätzlich, unabhängig vom Schlüssel: XLSX bei maximal 50 000 Zeilen, ICS bei maximal 5000 Terminen (s. o.) — CSV, NDJSON und SQLite sind unbegrenzt, weil sie gestreamt geschrieben werden.

Wer wirklich den kompletten, ungefilterten Datensatz braucht: einmal täglich (18:30 Uhr) wird ein vollständiger Export in allen Formaten vorgebaut — /kalender/export/voll.<format> — der zählt nicht gegen das stündliche Downloadkontingent und muss nicht bei jeder Anfrage neu berechnet werden. Der beste Weg, nicht an die Grenze zu stossen: erst filtern (Zeitraum, Währung, Wichtigkeit, Kategorie), dann laden — nicht andersherum.

Zurück zum Wirtschaftskalender · Originalquellen