Es stehen einige interne Funktionen zur Verfügung, um z.B. Zeichenketten korrekt für Hyperlinks zu codieren.
Hinweise
Syntax
sf_<funktionsname>( <argument> )
Alle Angaben in < > sind Pflichtangaben.
Beispiel: sf_base64_encode(EIN TEXT) Ergebnis: RUlOIFRFWFQ=
Schachteln von Funktionen
Das Schachteln von Funktionen ist aus Performance-Gründen nur einmalig möglich, anstatt der runden Klammern () sind für die innere Funktion die geschweiften Klammern {} zu verwenden.
sf_<funktionsname>( sf_<funktionsname>{<argument>} )
Alle Angaben in < > sind Pflichtangaben.
Beispiel: sf_base64_decode( sf_base64_encode{EIN TEXT} ) Ergebnis EIN TEXT
Liste der Funktionen
Alle im Dialog zur Konfiguration mit Sternchen gekennzeichneten Felder müssen ausgefüllt werden.
| sf_base64_encode(<zeichenkette>) | Codiert die Zeichenkette in base64.
Beispiel: sf_base64_encode(text)
|
| sf_base64_decode(<zeichenkette>) | Dekodiert eine base64-codierte Zeichenkette.
Beispiel: sf_base64_decode(RUlOIFRFWFQ=)
|
| sf_url_encode(<zeichenkette>) | Codiert die Zeichenkette in url-codiert, um den Wert in
Hyperlinks als Parameter verwenden zu können.
Beispiel: sf_url_encode(ein Text mit Leerzeichen)
|
| sf_url_decode(<zeichenkette>) | Dekodiert die url-codierte Zeichenkette.
Beispiel: sf_url_decode(ein+Text+mit+Leerzeichen)
|
| sf_htmlentities(<zeichenkette>) | Wandelt Zeichen in HTML-Codes um.
Beispiel: sf_htmlentities(<ein text>)
|
| sf_unhtmlentities(<zeichenkette>) | Wandelt alle HTML-Entities in Zeichen um.
Beispiel: sf_unhtmlentities(<ein text>)
|
| sf_sha1(<zeichenkette>) | Berechnet den sha1-Hash.
Beispiel: sf_sha1(abc)
|
| sf_md5(<zeichenkette>) | Berechnet den md5-Hash.
Beispiel: sf_md5(abc)
|
| sf_sha2_256(<zeichenkette>), sf_sha2_384(<zeichenkette>), sf_sha2_512(<zeichenkette>) | Berechnet den sha2-Hash.
Beispiel: sf_sha2_256(abc)
|
| sf_domain_part(<email-adresse>) | Gibt den Domainteil einer E-Mail-Adresse zurück. Enthält
die Zeichenkette kein @-Zeichen, wird eine leere Zeichenkette
zurückgegeben.
Beispiel: sf_domain_part(max@mustermann.de) => mustermann.de
|
| sf_local_part(<email-adresse>) | Gibt den lokalen Teil einer E-Mail-Adresse zurück.
Enthält die Zeichenkette kein @-Zeichen, wird eine leere Zeichenkette
zurückgegeben.
Beispiel: sf_local_part(max@mustermann.de) => max
|
| sf_tld(<email-adresse>) | Gibt die Top-Level-Domain einer E-Mail-Adresse zurück.
Enthält die Zeichenkette kein @-Zeichen, wird eine leere Zeichenkette
zurückgegeben.
Beispiel: sf_tld(max@mustermann.de) => de
|
| sf_lowercase(<zeichenkette>) | Wandelt die Zeichenkette in Kleinbuchstaben um.
|
| sf_uppercase(<zeichenkette>) | Wandelt die Zeichenkette in Großbuchstaben um.
|
| sf_lcfirst(<zeichenkette>) | Wandelt das erste Zeichen der Zeichenkette in einen
Kleinbuchstaben um.
|
| sf_ucfirst(<zeichenkette>) | Wandelt das erste Zeichen der Zeichenkette in einen
Großbuchstaben um.
|
| sf_trim(<zeichenkette>) | Entfernt führende/nachfolgende Leerzeichen.
|
| sf_ltrim(<zeichenkette>) | Entfernt führende Leerzeichen.
|
| sf_rtrim(<zeichenkette>) | Entfernt nachfolgende Leerzeichen.
|
| sf_nl2br(<zeichenkette>) | Wandelt alle Zeilenumbrüche in <br> um.
|
| sf_hex(<zahl>) | Wandelt die angegebene Zeichenkette in Dezimalzahl und
danach in eine Hexadezimal-Zahl.
Beispiel: sf_hex(12345)
|
| sf_rand(<zahl>) | Erstellt eine Zufallszahl im angegebenen Bereich.
Beispiel: sf_rand(10)
|
| sf_add(<zahl>, <zahl>[, <zahl>...]) | Addiert die mit Komma getrennten Zahlen.
Beispiel: sf_add(1, 2, 3)
|
| sf_sub(<zahl>, <zahl>[, <zahl>...]) | Subtrahiert die mit Komma getrennten Zahlen.
Beispiel: sf_sub(3, 2, 1)
|
| sf_mul(<zahl>, <zahl>[, <zahl>...]) | Multipliziert die mit Komma getrennten Zahlen.
Beispiel: sf_mul(3, 2, 1)
|
| sf_div(<zahl>, <zahl>[, <zahl>...]) | Multipliziert die mit Komma getrennten Zahlen.
Beispiel: sf_div(3, 2)
|
| sf_abs(<zahl>) | Gibt den Absolutwert/Betrag einer Zahl zurück.
Beispiel: sf_abs(-123) oder z.B. sf_abs(sf_sub{3, 10})
|
| sf_toint(<gleitkommazahl>) | Wandelt eine Gleitkommazahl in eine Ganzzahl, dabei werden
die Stellen nach dem Punkt abgeschnitten. Alternativ wird eine Zahl in
Hexadezimalschreibweise in eine Ganzzahl umgewandelt. Die
Hexadezimalzahl muss mit 0x beginnen, ansonsten wird diese als
Zeichenkette angesehen.
Beispiel: sf_toint(123.456) oder sf_toint(0xFFAAFF)
|
| sf_rand_string_mixed(<laenge>) |
Erstellt eine Zufallszeichenkette bestehend aus
Groß-/Kleinbuchstaben und Zahlen.
Mit <laenge> kann die Länge der Zufallszeichenkette angegeben werden, Standard ist 8 Zeichen.
|
| sf_rand_string_uppercase(<laenge>) | Erstellt eine Zufallszeichenkette bestehend aus
Großbuchstaben und Zahlen.
Mit <laenge> kann die Länge der Zufallszeichenkette angegeben werden, Standard ist 8 Zeichen.
|
| sf_rand_string_lowercase(<laenge>) | Erstellt eine Zufallszeichenkette bestehend aus
Kleinbuchstaben und Zahlen.
Mit <laenge> kann die Länge der Zufallszeichenkette angegeben werden, Standard ist 8 Zeichen.
|
| sf_rand_string_from_array(<wert1>,<wert2>,<wert3>...) | Wählt zufällig einen Wert aus der mit Komma-separierten
Liste aus.
Beispiel: sf_rand_string_from_array(a, b, c, d, e, f)
|
| sf_substring(<string>, <start>, [laenge]) | Ermittelt eine Teilzeichenkette. <start> muss ein
Wert >= 1 sein, laenge optional die Anzahl Zeichen die aus
<string> extrahiert werden sollen.
|
| sf_today([format]) | Gibt das aktuelle Datum aus, die Ausgabe erfolgt so, wie
im Windows-System definiert, im deutschsprachigen Bereich ist das
tag.monat.jahr. Ohne Angabe einer Formatierung entspricht sf_today() dem
Standard-Platzhalter [Datum_kurz].
Für [format] kann eine Formatierung des Datums angegeben werden, die Platzhalter finden Sie am Ende dieser Seite. Beispiele sf_today() => 04.02.2021 sf_today(ddddd) => Ausgabe ebenfalls 04.02.2021 sf_today(mmmm) => Februar
|
| sf_tomorrow([format]) | Gibt das morgige Datum aus, die Ausgabe erfolgt so, wie im
Windows-System definiert, im deutschsprachigen Bereich ist das
tag.monat.jahr.
Für [format] kann eine Formatierung des Datums angegeben werden, die Platzhalter finden Sie am Ende dieser Seite.
|
| sf_yesterday([format]) | Gibt das gestrige Datum aus, die Ausgabe erfolgt so, wie
im Windows-System definiert, im deutschsprachigen Bereich ist das
tag.monat.jahr.
Für [format] kann eine Formatierung des Datums angegeben werden, die Platzhalter finden Sie am Ende dieser Seite.
|
| sf_incdays(<datum>, <tage>[, zielformat][, quellformat]) | Addiert auf das angegebene Datum die Anzahl Tage und gibt
das neue Datum aus. Sind die Anzahl Tage negativ, dann werden die Tage
subtrahiert. Das Datum und Anzahl Tage sind Pflichtangaben, zielformat
und quellformat optional. Die Angabe von quellformat muss erfolgen, wenn
das Datum von der Windows-Einstellung abweicht.
Für [zielformat] [quellformat] kann eine Formatierung des Datums angegeben werden, die Platzhalter finden Sie am Ende dieser Seite. Beispiele sf_incdays(04.02.2021, 10) => 14.02.2021 sf_incdays(04.02.2021, -10) => 25.01.2021 sf_incdays(04.02.2021, 30, mmyyyy) => 032021 MySQL-Datumsformat Jahr-Monat-Tag wird als Quellformat angegeben, Zielformat ist leer, damit wird das Windows-Standard-Format verwendet sf_incdays(2021-02-04, 10, ,yyyy-mm-dd) => 14.02.2021 Ausgabe deutsches Datumsformat in der Form Jahr-Monat-Tag sf_incdays(04.02.2021, 14, yyyy-mm-dd) => 2021-02-18
|
| sf_incweeks(<datum>, <wochen>[, zielformat][, quellformat]) | Addiert auf das angegebene Datum die Anzahl Wochen und
gibt das neue Datum aus. Sind die Anzahl Wochen negativ, dann werden die
Wochen subtrahiert. Das Datum und Anzahl Wochen sind Pflichtangaben,
zielformat und quellformat optional. Die Angabe von quellformat muss
erfolgen, wenn das Datum von der Windows-Einstellung abweicht.
Für [zielformat] [quellformat] kann eine Formatierung des Datums angegeben werden, die Platzhalter finden Sie am Ende dieser Seite. Beispiele indentisch wie sf_incdays() nur mit Wochen
|
| sf_incyears(<datum>, <jahre>[, zielformat][, quellformat]) | Addiert auf das angegebene Datum die Anzahl Jahre und gibt
das neue Datum aus. Sind die Anzahl Jahre negativ, dann werden die Jahre
subtrahiert. Das Datum und Anzahl Jahre sind Pflichtangaben, zielformat
und quellformat optional. Die Angabe von quellformat muss erfolgen, wenn
das Datum von der Windows-Einstellung abweicht.
Für [zielformat] [quellformat] kann eine Formatierung des Datums angegeben werden, die Platzhalter finden Sie am Ende dieser Seite. Beispiele indentisch wie sf_incdays() nur mit Jahren
|
Formatierung von Datum/Uhrzeit
Die Bezeichner zur Formatierung des Datums/Uhrzeit sind nicht kompatibel zu den Bezeichnern in der PHP Newsletter Software SuperWebMailer.
/
Zeigt als Datumstrennzeichen das in der globalen Windows-Variablen
Datumsseparator angegebene Zeichen an.
:
Zeigt als Uhrzeittrennzeichen das in der globalen Windows-Variablen
Zeitseparator angegebene Zeichen an.
c
Zeigt das Datum in dem in der globalen Variablen kurzes Datumsformat angegebenen
Format an. Dahinter wird die Uhrzeit, in dem in der globalen Variablen langes
Zeitformat festgelegten Format dargestellt. Die Uhrzeit erscheint nicht, wenn
der Datums-/Zeitwert exakt Mitternacht ergibt.
d
Zeigt den Tag als Zahl ohne führende Null an (1-31).
dd
Zeigt den Tag als Zahl mit führender Null an (01-31).
ddd
Zeigt den Wochentag als Abkürzung (Son-Sam) in den in der globalen Variablen
kurze Tagesnamen festgelegten Strings an.
dddd
Zeigt den ausgeschriebenen Wochentag (Sonntag-Samstag) in den in der globalen
Variablen lange Tagesnamen festgelegten Strings an.
ddddd
Zeigt das Datum in dem in der globalen Variablen kurzes Datumsformat angegebenen
Format an, dies ist normalerweise tt.mm.jjjj.
dddddd
Zeigt das Datum in dem in der globalen Variablen langes Datumsformat angegebenen
Format an, dies ist normalerweise tt.mm.jjjj hh:mm:ss.
m
Zeigt den Monat als Zahl ohne führende Null an (1-12). Wenn auf den Bezeichner
m unmittelbar der Bezeichner h oder hh folgt, werden an Stelle des Monats die
Minuten angezeigt.
mm
Zeigt den Monat als Zahl mit führender Null an (01-12). Wenn auf den Bezeichner
mm unmittelbar der Bezeichner h oder hh folgt, werden an Stelle des Monats die
Minuten angezeigt.
mmm
Zeigt den Monatsnamen als Abkürzung (Jan-Dez) in den in der globalen Variablen
kurze Monatsnamen festgelegten Strings an.
mmmm
Zeigt den ausgeschriebenen Monatsnamen (Januar-Dezember) in den in der globalen
Variablen lange Monatsnamen festgelegten Strings an.
yy
Zeigt das Jahr als zweistellige Zahl an (00-99).
yyyy
Zeigt das Jahr als vierstellige Zahl an (0000-9999).
h
Zeigt die Stunde ohne führende Null an (0-23).
hh
Zeigt die Stunde mit führender Null an (00-23).
n
Zeigt die Minute ohne führende Null an (0-59).
nn
Zeigt die Minute mit führender Null an (00-59).
s
Zeigt die Sekunde ohne führende Null an (0-59).
ss
Zeigt die Sekunde mit führender Null an (00-59).
z
Zeigt die Millisekunde ohne führende Null an (0-999).
zzz
Zeigt die Millisekunde mit führender Null an (000-999).
t
Zeigt die Uhrzeit in dem in der globalen Variablen kurzes Datumsformat
angegebenen Format an.
tt
Zeigt die Uhrzeit in dem in der globalen Variablen langes Zeitformat angegebenen
Format an.
am/pm
Verwendet die 12-Stunden-Zeitanzeige für den vorhergehenden Bezeichner h oder
hh und zeigt alle Stunden vor Mittag mit dem String 'am' und alle Stunden nach
Mittag mit dem String 'pm' an. Der Bezeichner am/pm kann in Großbuchstaben, in
Kleinbuchstaben oder in gemischter Schreibweise eingegeben werden. Die Ausgabe
wird entsprechend angepasst.
a/p
Verwendet die 12-Stunden-Zeitanzeige für den vorhergehenden Bezeichner h oder
hh und zeigt alle Stunden vor Mittag mit dem Zeichen 'a' und alle Stunden nach
Mittag mit dem Zeichen 'p' an. Der Bezeichner a/p kann in Großbuchstaben, in
Kleinbuchstaben oder in gemischter Schreibweise eingegeben werden. Die Ausgabe
wird entsprechend angepasst.
ampm
Verwendet die 12-Stunden-Zeitanzeige für den vorhergehenden Bezeichner h oder
hh und zeigt alle Stunden vor Mittag mit dem String aus der globalen Variablen
TimeAMString und alle Stunden nach Mittag mit dem String aus der globalen
Variable TimePMString an.