Berechnungen & Konstanten

Die Vorlagen-Engine bringt eingebaute Konstanten und Funktionen für Datum und Rechnen mit — ohne eigene Datenanbindung.

Das aktuelle Datum (now)

@now ist eine eingebaute Konstante mit dem aktuellen Datum und der Uhrzeit des Servers, im Format yyyy-MM-dd HH:mm:ss. Sie können sie um einen Betrag und eine Einheit verschieben und über dateFormat für die Anzeige aufbereiten.

Parameter

Argument	Typ	Beschreibung
amount	number	Verschiebung (positiv oder negativ)
qualifier	string	Einheit: years/y, months/mm, days/d, hours/h, minutes/m, seconds/s, milliseconds/ms

Beispiel — angenommen, es ist der 22.07.2025, 08:00:00

{{ @now }}                          -> '2025-07-22 08:00:00'
{{ @now(-2, hours) }}               -> '2025-07-22 06:00:00'
{{ @now(-30, minutes) }}            -> '2025-07-22 07:30:00'
{{ @now | dateFormat:'dd-MM-yyyy' }} -> '22-07-2025'

Praktisch, um Rechnungen und Meldungen mit dem Erstellungszeitpunkt zu versehen.

---

Datumsdifferenz

Berechnet die Differenz zwischen zwei Daten. Es wird angenommen, dass date1 vor date2 liegt; sonst kommt eine negative Zahl zurück.

dateDiff date1 date2 operator fractionalResult

Argument	Typ	Beschreibung
date1	string	Startzeitpunkt
date2	string	Endzeitpunkt
operator	string	Einheit: year, month, week, day, hour, minute, second
fractionalResult	boolean	Optional: 'true' liefert ein Ergebnis mit Nachkommastellen

Beispiel — Liegezeit von der Ankunft bis zur Abfahrt

{{dateDiff '2025-07-20 06:00:00' '2025-07-22 18:30:00' 'days' }}         => 2
{{dateDiff '2025-07-20 06:00:00' '2025-07-22 18:30:00' 'days' 'true' }}  => 2.52083333...
{{dateDiff '2025-07-20 06:00:00' '2025-07-22 18:30:00' 'hours' }}        => 60

---

Math

Führt eine einfache Rechenoperation mit zwei Werten aus.

math number operator value

Argument	Typ	Beschreibung
number	string	Die Ausgangszahl
operator	string	Eines von: +, -, *, /
value	string	Der zweite Operand

Beispiel

{{math 75000 '*' 0.05 }}   => 3750    (5 % Hafengeld auf 75.000 t Ladung)
{{math 1250 '/' 4 }}       => 312.5   (Rechnung auf 4 Kunden aufgeteilt)
{{math 48 '+' 12 }}        => 60      (Gesamtfahrzeit in Stunden)

---

Rechnen über eine Liste (mathArray)

Führt eine Auswertung über ein Array aus: Summe, Durchschnitt, Minimum, Maximum, Anzahl oder Summenprodukt.

mathArray value method property

Argument	Typ	Beschreibung
value	array	Das auszuwertende Array
method	string	Eines von: average, count, max, min, sum, sumproduct
property	string	Das Feld, das je Element gelesen wird (bei einfachen Wertearrays weglassen)

Beispiel

Mit diesen Daten:
{
  shipments: [
    { "vessel": "Ocean Star",  "customer": "Blue Tide Shipping", "tonnage": 52000 },
    { "vessel": "Blue Marlin", "customer": "Maas Bulk",          "tonnage": 38000 },
    { "vessel": "Nordic Wind", "customer": "Delta Logistics",    "tonnage": 71000 },
    { "vessel": "Cape Horn",   "customer": "Maas Bulk",          "tonnage": 45000 }
  ],
  portCalls: [4, 7, 3, 6]
}

{{mathArray shipments 'count' }}               => 4
{{mathArray shipments 'sum' 'tonnage' }}        => 206000
{{mathArray shipments 'average' 'tonnage' }}    => 51500
{{mathArray shipments 'min' 'tonnage' }}        => 38000
{{mathArray shipments 'max' 'tonnage' }}        => 71000
{{mathArray portCalls 'sum' }}                  => 20