Startseite > Template- und Themeprogrammierung > Skriptsprache > Numerische Befehle

Numerische Befehle

number

Der <liquid>number</liquid> Filter nimmt einen string oder number Wert entgegen und gibt einen numerischen Wert zurück. Dabei wird das konfigurierte Land des Shops berücksichtigt.
Dem Filter kann ein Parameter übergeben werden - wahlweise "currency" oder "percent" - um die Ausgabe im Format Währung oder Prozent auszugeben, ohne die Ausgabe der jeweiligen Währungssymbole (€, CHF) oder des Prozentzeichens (%).

<liquid-input>
{{ '1234.5' | number }}
{{ 1234.5 | number }}
{{ '-1234.5' | number }}
{{ -1234.5 | number }}
</liquid-input>
<liquid-output>
1.234,500
1.234,500
-1.234,500
-1.234,500
</liquid-output>

<liquid-input>
{{ '2.4' | number: 'currency' }}
{{ 2.4 | number: 'currency' }}
{{ '-2.4' | number: 'currency' }}
{{ -2.4 | number: 'currency' }}
</liquid-input>
<liquid-output>
2,40
2,40
-2,40
-2,40
</liquid-output>

<liquid-input>
{{ '123.45' | number: 'percent' }}
{{ 1234.56 | number: 'percent' }}
{{ '-15.45' | number: 'percent' }}
{{ -25.56 | number: 'percent' }}
</liquid-input>
<liquid-output>
123
1.235
-15
-26
</liquid-output>

currency

Der <liquid>currency</liquid> Filter gibt einen numerischen Wert im Währungsformat zurück. Dabei wird das konfigurierte Land des Shops berücksichtigt.

<liquid-input>
{{ '2.4' | currency }}
{{ -2.4 | currency }}
{{ 2000.4 | currency }}
</liquid-input>
<liquid-output>
2,40 €
-2,40 €
2.000,40 €
</liquid-output>

percent

Der <liquid>percent</liquid> Filter gibt einen numerischen Wert im Prozentformat zurück. Dabei wird das konfigurierte Land des Shops berücksichtigt.

<liquid-input>
{{ '2.4' | percent }}
{{ 2.6 | percent }}
{{ -2.4 | percent }}
{{ 2000.4 | percent }}
</liquid-input>
<liquid-output>
2%
3%
-2%
2.000%
</liquid-output>

lpad

Der <liquid>lpad</liquid> Filter füllt den übergebenen Wert mit Nullen auf (links beginnend) bis der Wert die Länge des übergebenden ersten Parameters hat. Wird ein zweites Argument übergeben, enthält dieses den String mit dem aufgefüllt wird.

<liquid-input>
{{ 123 | lpad: 5 }}
{{ 123 | lpad: 5, '-' }}
</liquid-input>

<liquid-output>
00123
--123
</liquid-output>

rpad

Der <liquid>rpad</liquid> Filter füllt den übergebenen Wert mit Nullen auf (rechts beginnend) bis der Wert die Länge des übergebenden ersten Parameters hat. Wird ein zweites Argument übergeben, enthält dieses den String mit dem aufgefüllt wird.

<liquid-input>
{{ 123 | rpad: 5 }}
{{ 123 | rpad: 5, '-' }}
</liquid-input>

<liquid-output>
12300
123--
</liquid-output>

tochar

Der <liquid>tochar</liquid> Befehl wandelt den übergebenen ASCII-Code in das passende Zeichen um.

<liquid-input>
{% tochar 65 %}
{% tochar 0x5a %}
</liquid-input>

<liquid-output>
A
Z
</liquid-output>

plus

Der <liquid>plus</liquid> Filter addiert zum übergebenen Wert den hinzugefügten Parameter und gibt das Ergebnis aus.

<liquid-input>
{{ 1 | plus: 1 }}
{{ '1' | plus: 1 }}
{{ '1' | plus: '1' }}
{{ 1.5 | plus: 1.5 }}
</liquid-input>

<liquid-output>
2
2
2
3
</liquid-output>

minus

Der <liquid>minus</liquid> Filter subtrahiert vom übergebenen Wert den hinzugefügten Parameter und gibt das Ergebnis aus.

<liquid-input>
{{ 1 | minus: 1 }}
{{ '1' | minus: 1 }}
{{ '1' | minus: '1' }}
{{ 1.5 | minus: 1.5 }}
</liquid-input>

<liquid-output>
0
0
0
0
</liquid-output>

times

Der <liquid>times</liquid> Filter multipliziert den übergebenen Wert mit dem hinzugefügten Parameter und gibt das Ergebnis aus.

<liquid-input>
{{ 2 | times: 2 }}
{{ '2' | times: 2 }}
{{ '2' | times: '2' }}
{{ 1.5 | times: 1.5 }}
</liquid-input>

<liquid-output>
4
4
4
2.25
</liquid-output>

divided_by

Der <liquid>divided_by</liquid> Filter dividiert den übergebenen Wert durch den hinzugefügten Parameter und gibt das Ergebnis aus. Der zweite Parameter definiert die Anzahl an Nachkommastellen.

<liquid-input>
{{ 4 | divided_by: 2 }}
{{ 10 | divided_by: 3, 2 }}
{{ '4' | divided_by: 2 }}
{{ '4' | divided_by: '2' }}
{{ '4.4' | divided_by: '2.2' }}
</liquid-input>

<liquid-output>
2
3.33
2
2
2
</liquid-output>

abs

Der <liquid>abs</liquid> Filter gibt den absoluten Wert des übergebenen Inputs aus. Sollte ein negativer Wert übergeben werden, wandelt ihn <liquid>abs</liquid> in einen positiven Wert um.

<liquid-input>
{{ 12 | abs }}
{{ -3 | abs }}
{{ '-3' | abs }}
{{ 4.4 | abs }}
{{ '4.4' | abs }}
</liquid-input>

<liquid-output>
12
3
3
4.4
4.4
</liquid-output>

ceil

Der <liquid>ceil</liquid> Filter rundet den übergebenen Wert auf die nächsthöhere Ganzzahl und gibt das Ergebnis aus.

<liquid-input>
{{ 12 | ceil }}
{{ 12.01 | ceil }}
{{ -12.01 | ceil }}
{{ '12.01' | ceil }}
</liquid-input>

<liquid-output>
12
13
-12
13
</liquid-output>

floor

Der <liquid>floor</liquid> Filter rundet den übergebenen Wert auf die nächstniedrigere Ganzzahl ab und gibt das Ergebnis aus.

<liquid-input>
{{ 12 | floor }}
{{ 12.99 | floor }}
{{ -12.99 | floor }}
{{ '12.99' | floor }}
</liquid-input>

<liquid-output>
12
12
-13
12
</liquid-output>

modulo

Der <liquid>modulo</liquid> Filter gibt den Rest der Ganzzahldivision der beiden übergebenen Wert aus.

<liquid-input>
{{ 12 | modulo: 5 }}
{{ 12 | modulo: 2 }}
{{ '12' | modulo: 5 }}
{{ 4.4 | modulo: 2.2 }}
</liquid-input>

<liquid-output>
2
0
2
0
</liquid-output>

round

Der <liquid>round</liquid> Befehl rundet eine Zahl auf bzw. ab. Wird als Argument eine Zahl angegeben, wird auf die Anzahl an Dezimalstellen auf- bzw. abgerundet.

<liquid-input>
{{ 1.2 | round }}
{{ 1.5 | round }}
{{ 1.2420 | round:2 }}
{{ 1.2480 | round:2 }}
</liquid-input>

<liquid-output>
1
2
1.24
1.25
</liquid-output>