Verwenden Sie diese DataStage -Funktionen in Orchestration Pipelines-Codeeditoren, um beispielsweise eine Benutzervariable zu definieren oder eine erweiterte Bedingung zu erstellen.
Syntax für Expression Builder-Funktionen
In der Syntax für Argumente geben eckige Klammern an, dass ein Argument optional ist.
Ein Parameter kann Daten beliebigen Typs akzeptieren. Sie können ein Argument des Typs 'string', 'int', 'float', 'null' und andere Typen eingeben. Die Funktion IsNull(input (any)) akzeptiert beispielsweise die folgenden Parametertypen, ist jedoch nicht exklusiv für die folgenden Typen:
ds.IsNull(1)
ds.IsNull("try null")
ds.IsNull(1.78)
ds.IsNull(null)
Expression Builder verwendet diese Kategorien für die Codierung von Funktionen:
Konvertierungsfunktion
Konvertiert ein einzelnes Datenelementformat in ein anderes Format.
Ascii
Konvertiert die Werte von Zeichen in einer Zeichenfolge aus dem EBCDIC-in das ASCII-Format.
Syntax
ds.Ascii(input (string))
returns: Die EDBCDI-Zeichenfolge wurde in eine resultierende ASCII-Zeichenfolge aus Formatierzeichenfolge konvertiert.
Beispiel
Der folgende Code gibt "65 66 67" zurück:
ds.Ascii("193 194 195")
Char
Gibt ein ASCII-Zeichen aus seinem numerischen Codewert zurück.
Syntax
ds.Char(code (uint8))
returns: Das entsprechende Zeichen des Formats char.
Beispiel
Im folgenden Beispiel wird der ASCII-Code 65 als Buchstabe A ausgegeben.
ds.Char(65)
Checksum
Gibt einen zyklischen Blockcodewert für eine Zeichenfolge zurück.
Syntax
ds.Checksum(input (string))
Rückgabewerte: Der Kontrollsummenwert einer Formatierzeichenfolge, die zyklischer Redundanzcode ist.
Beispiel
Der folgende Code gibt 57158 zurück:
ds.Checksum("This is any arbitrary string value")
CRC32
Verwendet die Funktion CRC32 , um einen zyklischen 16-Bit-Redundanzcode zurückzugeben
Syntax
ds.CRC32(input (string))
returns: Ergebnis des Formats 'decimal'.
Beispiel
Der folgende Code gibt 57158 zurück:
ds.CRC32("This is any arbitrary string value")
DateToString
Gibt die Zeichenfolgedarstellung des Datums zurück Die Standardformatierungszeichenfolge für Datumsangaben ist "%yyyy%mm%dd". Daher wird beispielsweise das Datum 2009-08-25 als Dezimalzahl 20090825 gespeichert. Sie können jedoch optional eine Formatierzeichenfolge angeben, die festlegt, wie das Datum in der Dezimalzahl gespeichert wird. Formatzeichenfolgen müssen ein Format angeben, das nur Zahlen enthält. Sie können beispielsweise keine Formatierungszeichenfolge wie "%yyyy-%mm-%dd" angeben, da der Bindestrich (-) nicht in einem gepackten Dezimalwert gespeichert werden kann. Die folgenden Tokens können für die Konvertierung von oder in Dezimalwerte verwendet werden:
%yyyy (four-digit year)
%yy (two-digit year)
%NNNNyy (two-digit year with cutoff)
%mm (two-digit month)
%dd (two-digit day of month)
%ddd (three-digit day of year)
Die Literalziffern 0 bis 9 sind ebenfalls gültig.
Syntax
ds.DateToString(date (date), [format (string)])
gibt das Datum im Zeichenfolgeformat zurück.
Beispiel
Wenn mylink.mydate das Datum 18th August 2009 enthält, gibt der folgende Code die Zeichenfolge "2009-08-18" zurück:
ds.DateToString(mylink.mydate)
Im folgenden Beispiel wird das Datum, das in der Spalte mylink.mydate enthalten ist, in eine Zeichenfolge im Format dd:mm:yyyyausgegeben. Wenn mylink.mydate das Datum 18th August 2009 enthielt, gibt der folgende Code die Zeichenfolge "18:08:2009" zurück:
ds.DateToString(mylink.mydate, "%dd:%mm:%yyyy")
DateToDecimal
Gibt das angegebene Datum als gepackten Dezimalwert zurück. Die Standardformatierungszeichenfolge für Datumsangaben ist "%yyyy%mm%dd". Daher wird beispielsweise das Datum 2009-08-25 als Dezimalzahl 20090825 gespeichert. Sie können jedoch optional eine Formatierzeichenfolge angeben, die festlegt, wie das Datum in der Dezimalzahl gespeichert wird. Formatzeichenfolgen müssen ein Format angeben, das nur Zahlen enthält. Sie können beispielsweise keine Formatierungszeichenfolge wie "%yyyy-%mm-%dd" angeben, da der Bindestrich (-) nicht in einem gepackten Dezimalwert gespeichert werden kann. Die folgenden Tokens können für die Konvertierung von oder in Dezimalwerte verwendet werden:
%yyyy (four-digit year)
%yy (two-digit year)
%NNNNyy (two-digit year with cutoff)
%mm (two-digit month)
%dd (two-digit day of month)
%ddd (three-digit day of year)
Die Literalziffern 0 bis 9 sind ebenfalls gültig.
Syntax
ds.DateToDecimal(basedate (date), [format (string)])
gibt das Datum im Dezimalzahlenformat zurück.
Beispiel
Wenn mylink.basedate das Datum 2012-08-18 enthält, speichert die folgende Funktion das Datum als Dezimalzahl 18082012:
ds.DateToDecimal(mylink.basedate, "%dd%mm%yyyy")
Wenn mylink.basedate das Datum 2012-08-18 enthält, speichert die folgende Funktion das Datum als Dezimalzahl 20120818:
ds.DateToDecimal(mylink.basedate)
DecimalToDate
Gibt die angegebene gepackte Dezimalzahl als Datum zurück. Beim Konvertieren in ein Datum werden Vorzeichen und Anzahl der Kommastellen der Dezimalzahl ignoriert. Die Standardformatierungszeichenfolge ist "%yyyy%mm%dd", sodass beispielsweise das Datum 2009-08-25 als Dezimalzahl 20090825 gespeichert wird. Sie können jedoch optional eine Formatierzeichenfolge angeben, die festlegt, wie das Datum in der Dezimalzahl gespeichert wird. Formatzeichenfolgen dürfen nur ein Format angeben, das Zahlen enthält. Sie können beispielsweise keine Formatierungszeichenfolge wie "%yyyy-%mm-%dd" angeben, da der Bindestrich (-) nicht in einem gepackten Dezimalwert gespeichert werden kann. Die folgenden Tokens können für die Konvertierung von oder in Dezimalwerte verwendet werden:
%yyyy (four-digit year)
%yy (two-digit year)
%NNNNyy (two-digit year with cutoff)
%mm (two-digit month)
%dd (two-digit day of month)
%ddd (three-digit day of year)
Die Literalziffern 0 bis 9 sind ebenfalls gültig.
Syntax
ds.DecimalToDate(basedec (decimal), [format (string)])
gibt die Dezimalzahl im Datumsformat zurück.
Beispiel
Wenn mylink.mydecdata den Wert 18082012 enthält, gibt die folgende Funktion das Datum 2012-08-18 zurück:
ds.DecimalToDate(mylink.basedate, "%dd%mm%yyyy")
Wenn mylink.mydecdata den Wert -201208.18 enthält, gibt die folgende Funktion das Datum 2012-08-18 zurück:
ds.DecimalToDate(mylink.basedate)
DecimalToDecimal
Gibt die angegebene Dezimalzahl in Dezimaldarstellung zurück Das Argument rtype gibt optional einen Rundungstyp an und wird auf einen der folgenden Werte gesetzt:
ceil: Rundet das Quellfeld in Richtung positive Unendlichkeit. Beispiel: 1.4 -> 2, -1.6 -> -1
floor: Rundet das Quellenfeld in Richtung negative Unendlichkeit. Beispiel: 1.6 -> 1, -1.4 -> -2
round_inf:Rundet oder schneidet das Quellfeld auf den nächsten darstellbaren Wert ab, wobei Gleichstände durch Runden positiver Werte in Richtung positive Unendlichkeit und negativer Werte in Richtung negative Unendlichkeit umgewandelt werden. Beispiel: 1.4 -> 1, 1.5 -> 2, -1.4 -> -1, -1.5 -> -2
trunc_zero: Alle Nachkommastellen rechts von der äußersten rechten Nachkommastelle, die im Ziel unterstützt wird, unabhängig vom Vorzeichen verwerfen. Ist das Ziel beispielsweise eine Ganzzahl, werden alle Nachkommastellen entfernt. Wenn es sich bei dem Ziel um eine weitere Dezimalzahl mit einer kleineren Anzahl Kommastellen handelt, wird auf die Größe der Zieldezimalzahl gerundet oder abgeschnitten. Beispiel: 1,6 -> 1, -1,6 -> -1
Syntax
ds.DecimalToDecimal(decimal (decimal), [rtype (string)])
gibt die resultierende Dezimalzahl zurück.
Beispiel
Wenn mylink.mydec die Dezimalzahl 2.5345enthält, gibt die folgende Funktion die Dezimalzahl 2.54:
ds.DecimalToDecimal(mylink.mydec,"ceil")
Wenn mylink.mydec die Dezimalzahl 2.5345enthält, gibt die folgende Funktion die Dezimalzahl 2.53zurück:
ds.DecimalToDecimal(mylink.mydec,"floor")
Wenn mylink.mydec die Dezimalzahl 2.5345enthält, gibt die folgende Funktion die Dezimalzahl 2.53zurück:
ds.DecimalToDecimal(mylink.mydec,"trunc_zero")
Wenn mylink.mydec die Dezimalzahl 2.5345enthält, gibt die folgende Funktion die Dezimalzahl 2.53zurück:
ds.DecimalToDecimal(mylink.mydec,"round_inf")
DecimalToDFloat
Gibt die angegebene Dezimalzahl in einer Darstellung des Typs dfloat zurück. Das optionale Argument fix_zero gibt an, dass alle Nulldezimalwerte als gültig betrachtet werden (standardmäßig werden Dezimalzahlen, die nur Nullen enthalten, als ungültig behandelt).
Syntax
ds.DecimalToDFloat(decimal (decimal), ["fix_zero"])
gibt die Dezimalzahl im Format dfloat zurück.
Beispiele
Wenn mylink.mydec die Dezimalzahl 00000004.00enthält, gibt die folgende Funktion die dfloat -Zahl 4 zurück.
ds.DecimalToDFloat(mylink.mydec,"fix_zero")
Wenn mylink.mydec die Dezimalzahl 00012344.00enthält, gibt die folgende Funktion die dfloat -Zahl 12344 zurück.
ds.DecimalToDFloat(mylink.mydec,"fix_zero")
Wenn mylink.mydec die Dezimalzahl 00012344.120enthält, gibt die folgende Funktion die dfloat Zahl 12344.12zurück:
ds.DecimalToDFloat(mylink.mydec,"fix_zero")
Wenn mylink.mydec die Dezimalzahl 00012344.120enthält, gibt die folgende Funktion die dfloat-Zahl 12344.12zurück:
ds.DecimalToDFloat(mylink.mydec)
Wenn mylink.mydec die Dezimalzahl 00012344.000enthält, gibt die folgende Funktion die Gleitkommazahl 12344 zurück.
ds.DecimalToDFloat(mylink.mydec)
DecimalToString
Gibt die angegebene Dezimalzahl als Zeichenfolge zurück. Das Argument fix_zero gibt optional an, dass alle Nulldezimalwerte als gültig betrachtet werden (standardmäßig werden Dezimalzahlen, die nur Nullen enthalten, als ungültig behandelt). Dies gilt für den Fall, dass die Vorzeichenbits der gepackten Dezimaldarstellung alle 0 und alle Inhaltsziffern sind. Diese Umsetzung wird nur als gültig betrachtet, wenn fix_zero auf 'true' gesetzt ist.
Syntax
ds.DecimalToString(decimal (decimal), ["fix_zero"])
gibt die Dezimalzahl im Zeichenfolgeformat zurück.
Beispiele
Wenn mylink.mydec die Dezimalzahl 00000004.00enthält, gibt die folgende Funktion die Zeichenfolge "4" zurück:
ds.DecimalToString(mylink.mydec,"suppress_zero")
Wenn mylink.mydec die Dezimalzahl 00000004.00enthält, gibt die folgende Funktion die Zeichenfolge "0000000000000000000000000004.0000000000" zurück:
ds.DecimalToString(mylink.mydec,"fix_zero")
Wenn mylink.mydec die Dezimalzahl 00000004.00enthält, gibt die folgende Funktion die Zeichenfolge "4" zurück:
ds.DecimalToString(mylink.mydec)
DecimalToTime
Gibt die angegebene gepackte Dezimalzahl als Uhrzeit zurück. Sie können optional eine Formatzeichenfolge angeben, die festlegt, wie die Uhrzeit in der Dezimalzahl gespeichert wird. Die Standardformatzeichenfolge ist "%hh%nn%ss", sodass beispielsweise die Uhrzeit 14:03:22 als Dezimalzahl 140322 gespeichert wird. Formatzeichenfolgen müssen ein Format angeben, das nur Zahlen enthält. Sie können beispielsweise keine Formatierungszeichenfolge wie "%hh:%nn:%ss" angeben, weil der Doppelpunkt (:) nicht in einem gepackten Dezimalwert gespeichert werden kann. Die folgenden Tokens können für die Konvertierung von oder in Dezimalwerte verwendet werden:
%hh (two-digit hours that use 24-hour clock)
%nn (two-digit minutes)
%ss (two-digit seconds)
%ss.N (two-digit seconds, plus the number of fractional digits allowed. The number of fractional digits is from 1 - 6 inclusive).
Die Literalziffern 0 bis 9 sind ebenfalls gültig.
Wenn Ihr angegebenes Format Mikrosekunden (z. B. %ss.4) enthält, wird die Position des Dezimalzeichens im Dezimalwert abgeleitet. Die Position des Dezimalzeichens muss nicht mit der angegebenen Anzahl der Kommastellen übereinstimmen (z. B. Anzahl der Kommastellen = 4).
Syntax
ds.DecimalToTime(decimal (decimal), [format (string)])
returns: Die Dezimalzahl im Zeitformat.
Beispiel
Wenn mylink.mytimedec den Dezimalwert 200658 enthält, gibt die folgende Funktion die Zeit 20:06:58 zurück:
ds.DecimalToTime(mylink.mytimedec)
Wenn die Spalte 'mylink.mytimedec' den Dezimalwert 580620 enthält, gibt die folgende Funktion die Zeit 20:06:58 zurück:
ds.DecimalToTime(mylink.mytimedec, "%ss%nn%hh")
DecimalToTimestamp
Gibt die angegebene gepackte Dezimalzahl als Zeitmarke zurück. Sie können optional eine Formatzeichenfolge angeben, die festlegt, wie die Zeitmarke in der Dezimalzahl gespeichert wird. Die Standardformatzeichenfolge ist "%hh%nn%ss". Daher wird beispielsweise die Zeitmarke 2009-08-25 14:03:22 als Dezimalzahl 20090825140322 gespeichert. Formatzeichenfolgen müssen ein Format angeben, das nur Zahlen enthält. Sie können beispielsweise keine Formatierungszeichenfolge wie "%yyyy/%mm/%dt%hh: %nn:%ss" angeben, da der Schrägstrich (/) und der Doppelpunkt (:) nicht in einem gepackten Dezimalwert gespeichert werden können. Die folgenden Tokens können für die Konvertierung von oder in Dezimalwerte verwendet werden:
%yyyy (four-digit year)
%yy (two-digit year)
%NNNNyy (two-digit year with cutoff)
%mm (two-digit month)
%dd (two-digit day of month)
%ddd (three-digit day of year)
%hh (two-digit hours that use 24-hour clock)
%nn (two-digit minutes)
%ss (two-digit seconds)
%ss.N (two-digit seconds, plus the number of fractional digits allowed. The number of fractional digits is from 1 - 6 inclusive).
Die Literalziffern 0 bis 9 sind ebenfalls gültig.
Wenn Ihr angegebenes Format Mikrosekunden (z. B. %ss.4) enthält, wird die Position des Dezimalzeichens im Dezimalwert abgeleitet. Die Position des Dezimalzeichens muss nicht mit der angegebenen Anzahl der Kommastellen übereinstimmen (z. B. Anzahl der Kommastellen = 4).
Syntax
ds.DecimalToTimestamp(decimal (decimal), [format (string)])
returns: Dezimalzahl im Zeitmarkenformat.
Beispiel
Wenn mylink.mytimestampdec den Wert 19580818200658 enthält, gibt die folgende Funktion die Zeitmarke 1958-08-18 20:06:58 zurück:
ds.DecimalToTimestamp(mylink.mytimestampdec)
Wenn link.mytimestampdec den Dezimalwert 200658220818 enthält, gibt die folgende Funktion die Zeitmarke 2022-08-18 20:06:58 zurück:
ds.DecimalToTimestamp(mylink.mytimestampdec, "%hh%nn%ss%yy%mm%dd")
DFloatToDecimal
Gibt die angegebene DFLOAT-Zahl in der Dezimaldarstellung zurück. Das Argument rtype gibt optional einen Rundungstyp an und wird auf einen der folgenden Werte gesetzt:
ceil: Rundet das Quellfeld in Richtung positive Unendlichkeit. Beispiel: 1.4 -> 2, -1.6 -> -1
floor: Rundet das Quellenfeld in Richtung negative Unendlichkeit. Beispiel: 1.6 -> 1, -1.4 -> -2
round_inf:Rundet oder schneidet das Quellfeld auf den nächsten darstellbaren Wert ab, wobei Gleichstände durch Runden positiver Werte in Richtung positive Unendlichkeit und negativer Werte in Richtung negative Unendlichkeit umgewandelt werden. Beispiel: 1.4 -> 1, 1.5 -> 2, -1.4 -> -1, -1.5 -> -2
trunc_zero: Alle Nachkommastellen rechts von der äußersten rechten Nachkommastelle, die im Ziel unterstützt wird, unabhängig vom Vorzeichen verwerfen. Ist das Ziel beispielsweise eine Ganzzahl, werden alle Nachkommastellen entfernt. Wenn es sich bei dem Ziel um eine weitere Dezimalzahl mit einer kleineren Anzahl Kommastellen handelt, wird auf die Größe der Zieldezimalzahl gerundet oder abgeschnitten. Beispiel: 1,6 -> 1, -1,6 -> -1
Syntax
ds.DFloatToDecimal(number (dfloat), [rtype (string)])
gibt das Dezimalformat im dfloat-Format zurück.
Beispiele
Wenn mylink.myfloat die Gleitkommazahl 2.534enthält, gibt die folgende Funktion die Dezimalzahl 2.54:
ds.DFloatToDecimal(mylink.mydec,"ceil")
Wenn mylink.myfloat die dfloat-Zahl 2.534enthält, gibt die folgende Funktion die Dezimalzahl 2.53:
ds.DFloatToDecimal(mylink.mydec,"floor")
Wenn mylink.myfloat die dfloat-Zahl 2.534enthält, gibt die folgende Funktion die Dezimalzahl 2.53:
ds.DFloatToDecimal(mylink.mydec,"trunc_zero")
Wenn mylink.myfloat die dfloat-Zahl 2.534enthält, gibt die folgende Funktion die Dezimalzahl 2.53:
ds.DFloatToDecimal(mylink.mydec,"round_inf")
DfloatToStringNoExp
Gibt den angegebenen dfloat-Wert in seiner Zeichenfolgedarstellung ohne Exponenten unter Verwendung der angegebenen Skala zurück.
Syntax
ds.DfloatToStringNoExp(number (dfloat), scale (string))
gibt die dfloat-Zahl im Zeichenfolgeformat zurück.
Beispiele
Wenn mylink.myfloat die dfloat-Nummer 2.534enthält, gibt die folgende Funktion die Zeichenfolge "2.5" zurück:
ds.DfloatToStringNoExp(mylink.myfloat, "2")
Dtx
Konvertiert eine ganze Dezimalzahl in Hexadezimalzahlen.
Syntax
ds.Dtx(number (int32), size(int8))
returns: Das Ergebnis der Formatierzeichenfolge.
Beispiel
Der folgende Code liefert "002F":
ds.Dtx(47,4)
EBCDIC
Konvertiert jedes Zeichen eines Ausdrucks von seinem ASCII-Darstellungswert in seinen EBCDIC-Darstellungswert.
Syntax
ds.Ebcdic(input (string))
returns: Die ASCII-Zeichenfolge, die in eine resultierende EDBCDII-Zeichenfolge konvertiert wurde.
Beispiel
Der folgende Code gibt "193 194 195 64 241 242 243" zurück:
ds.Ebcdic("ABC 123")
Iconv
Konvertiert eine Zeichenfolge in ein internes Speicherformat.
Syntax
ds.Iconv(string (string), code (string))
returns: Das interne Speicherformat im Zeichenfolgeformat.
Beispiel
Der folgende Code gibt 10740 zurück:
ds.Iconv("27 MAY 97", "D2")
Der folgende Code gibt 10740 zurück:
ds.Iconv("1997 5 27", "D YMD")
IntToBool
Konvertiert eine ganze Zahl in einen boolescher Typ. Gibt 'true' für jeden Wert ungleich null und 'false' für 0 zurück.
Syntax
ds.IntToBool(integer (int))
returns: Der boolesche Wert 'true' oder 'false'.
Beispiel
Der Wert 2 gibt 'true' zurück.
ds.IntToBool(2)
IsValid
Gibt zurück, ob die angegebene Zeichenfolge für den angegebenen Typ gültig ist.
Gültige Typen sind "date", "decimal", "dfloat", "sfloat", "int8", "uint8", "int16", "uint16", "int32", "uint32", "int64","uint64"," Zeichenfolge "," Zeit "," Zeitmarke ".
Für die Datentypen 'date', 'time' und 'timestamp' können Sie optional eine Formatzeichenfolge angeben. Die Formatzeichenfolge beschreibt das Format, das verwendet wird, wenn Ihre Eingabedaten von den Standardformaten für Datum, Zeit oder Zeitmarke abweichen. Das Standardformat für das Datum ist "%yyyy-%mm-%dd". Das Standardformat für die Zeit ist "%hh:%mm:%ss". Das Standardformat für die Zeitmarke ist "%yyyy-%mm-%dt %hh: %mm:%ss". Für diese Funktion werden keine Warnungen protokolliert.
Syntax
ds.IsValid(type (string), teststring (string), [format (string)])
gibt ein Ergebnis vom Typ int8 zurück, 1 wenn die Eingabe für den angegebenen Typ gültig ist, andernfalls 0.
Beispiel
Wenn mylink.mystring die Zeichenfolge "1" enthält, gibt die folgende Funktion den Wert 1 zurück:
ds.IsValid("int8", mylink.mystring)
Wenn mylink.mystring die Zeichenfolge "380096.06" enthält, gibt die folgende Funktion den Wert 0 zurück:
ds.IsValid("int8", mylink.mystring)
IsValidDate
Gibt zurück, ob der angegebene Wert für den Typ 'date' gültig ist. Für diese Funktion werden Warnungen protokolliert.
Syntax
ds.IsValidDate(testdate (date))
gibt ein Ergebnis vom Typ int8 zurück, 1 wenn die Eingabe für den angegebenen Typ gültig ist, andernfalls 0.
Wenn mylink.mydate das Datum 2011-09-13 enthält, gibt die folgende Funktion den Wert 1 zurück:
ds.IsValidDate(mylink.mydate)
Wenn mylink.mydate die Zeichenfolge "380096.06" enthält, gibt die folgende Funktion den Wert 0 zurück, da die konvertierte Zeichenfolge kein gültiges Datum ist:
ds.IsValidDate(mylink.mydate)
IsValidDecimal
Gibt zurück, ob der angegebene Wert für den Typ 'decimal' gültig ist. Wenn allzerosflag auf 0 gesetzt ist, ist eine Darstellung mit Nullen nicht gültig. Der Wert für allzerosflag ist standardmäßig auf 0 gesetzt.
Syntax
ds.IsValidDecimal(testvalue (decimal), [allzerosflag (uint8)])
gibt ein Ergebnis vom Typ int8 zurück, 1 wenn die Eingabe für den angegebenen Typ gültig ist, andernfalls 0.
Beispiele
Wenn mylink.mynum den Wert 310007.65 enthält, gibt die folgende Funktion den Wert 1 zurück.
ds.IsValidDecimal(mylink.mynum)
IsValidTime
Gibt zurück, ob die angegebene Uhrzeit für den Typ 'time' gültig ist.
Syntax
ds.IsValidTime(testtime (time))
gibt ein Ergebnis vom Typ int8 zurück, 1 wenn die Eingabe für den angegebenen Typ gültig ist, andernfalls 0.
Beispiele
Wenn mylink.mytime die Zeit 23:09:22 enthält, gibt die folgende Funktion den Wert 1 zurück:
ds.IsValidTime(mylink.mytime)
IsValidTimestamp
Gibt zurück, ob die angegebene Zeitmarke für den Typ 'timestamp' gültig ist.
Syntax
ds.IsValidTimestamp(testtimestamp (timestamp))
gibt ein Ergebnis vom Typ int8 zurück, 1 wenn die Eingabe für den angegebenen Typ gültig ist, andernfalls 0.
Beispiele
Wenn mylink.mytimestamp die Zeit 2011-09-13 23:09:22 enthält, gibt die folgende Funktion den Wert 1 zurück:
ds.IsValidTimestamp(mylink.mytimestamp)
Oconv
Konvertiert einen Ausdruck in ein Ausgabeformat.
Syntax
ds.Oconv(expression (string), conversion (string))
returns: Das Ergebnis in ein Ausgabeformat der Formatierzeichenfolge.
Beispiel
Der folgende Code gibt 1997-147 zurück:
ds.Oconv(10740, "D-YJ")
Der folgende Code gibt den Wert 27 MAY 97 zurück:
ds.Oconv(10740, "D DMY, [A3,2]")
RawNumAt
Gibt den ganzzahligen Wert aus dem angegebenen Indexwert in dem angegebenen unformatierten Feld zurück. Der Index beginnt bei 0.
Syntax
ds.RawNumAt(rawfield (string), index (int32))
gibt den ganzzahligen Wert am Index im int32-Format zurück.
Beispiele
Wenn column mylink.myraw einen Rohwert enthält, der von der Zeichenfolge "hello" abgeleitet ist (dies ist "{ 0x68 0x65 0x6C 0x6C 0x6F }"), gibt die folgende Funktion die ganze Zahl 104 zurück (den ASCII-Code für das Zeichen h):
ds.RawNumAt(mylink.myraw, 0)
Wenn mylink.myraw einen unformatierten Wert enthält, der aus der Zeichenfolge "hello" abgeleitet wird (dies ist "{ 0x68 0x65 0x6C 0x6C 0x6F }")gibt die folgende Funktion 0 zurück, da der angegebene Index außerhalb des gültigen Bereichs liegt:
ds.RawNumAt(mylink.myraw, 12)
RawToString
Gibt den angegebenen unformatierten Wert als Zeichenfolgedarstellung zurück. Sie müssen sicherstellen, dass der unformatierte Eingabewert eine Bytefolge enthält, die ein gültiges Zeichen aus dem Zielzeichensatz darstellt, in dem die Ausgabezeichenfolge verwendet wird.
Beispiel: Der Rohwert { 0xE0 0x41 0x42 } ist keine gültige Folge von UTF-8-Zeichen, da das Leitbyte 0xE0 von einem Byte im Bereich [0x80..0xBF] gefolgt werden soll.
Wenn ein Rohwert ' { xE0 x41 x42 } an die Funktion RawToString übergeben wird, kann ein Fehler auftreten, wenn anschließend auf die Ausgabezeichenkette so zugegriffen wird, als wäre sie in UTF-8 kodiert.
Syntax
ds.RawToString(rawfield (string))
gibt den angegebenen Rohwert als Zeichenfolge zurück.
Beispiele
Wenn mylink.myraw den Wert { 0x31 0x31 0x30 0x35 0x32 0x32 0x30 0x39 } enthält, gibt die folgende Funktion die Zeichenfolge "11052209" zurück:
ds.RawToString(mylink.myraw)
Seq
Generiert einen numerischen Codewert aus einem ASCII-Zeichen. Sie können optional das Argument allow8bits angeben, um 8-Bit-ASCII-Werte zu konvertieren.
Syntax
ds.Seq(seq (char))
gibt den numerischen ASCII-Zeichencode zurück.
Beispiele
Das folgende Beispiel gibt für das Zeichen A den ASCII-Code 65 aus:
ds.Seq("A")
SeqAt
Gibt den numerischen Codepunktwert des Zeichens an der angegebenen Position in der angegebenen Zeichenfolge zurück. Der Index beginnt bei 0. Wenn der angegebene Index außerhalb des gültigen Bereichs liegt, gibt die Funktion 0 zurück.
Syntax
ds.SeqAt(basestring (string), index (int32))
gibt den numerischen Codepunktwert des Zeichens an der angegebenen Position in der angegebenen Zeichenfolge im int32-Format zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge "horse" enthält, gibt die folgende Funktion den Wert 0x6F (den ASCII-Wert des Zeichens o) zurück.
ds.SeqAt(mylink.mystring, 1)
StringToBool
Konvertiert eine Zeichenfolge in einen boolescher Typ. Gibt 'false' für leere Zeichenfolge und 'true' für alle anderen Werte zurück.
Syntax
ds.StringToBool(string (string))
returns: Der boolesche Wert 'true' oder 'false'.
Beispiel
Eine leere Zeichenfolge gibt ' false' zurück.
ds.StringToBool("")
StringToDate
Gibt ein Datum aus der angegebenen Zeichenfolge in dem angegebenen Format zurück. Sie müssen keine Formatzeichenfolge angeben, wenn Ihre Zeichenfolge ein Datum im Standardformat jjjj-mm-tt enthält.
Syntax
ds.StringToDate(string (string), [format (string)])
returns: Zeichenfolge bis Datum im angegebenen Format.
Beispiele
Wenn mylink.mystring die Zeichenfolge "1958-08-18" enthält, gibt die folgende Funktion das Datum 1958-08-18 zurück:
ds.StringToDate(mylink.mystring)
Wenn mylink.mystring die Zeichenfolge "18:08:1958" enthält, gibt die folgende Funktion das Datum 1958-08-18 zurück:
ds.StringToDate(mylink.mystring,"%dd:%mm:%yyyy")
StringToDecimal
Gibt die angegebene Zeichenfolge als Dezimaldarstellung zurück. Das Argument rtype gibt optional einen Rundungstyp an und wird auf einen der folgenden Werte gesetzt:
ceil: Rundet das Quellfeld in Richtung positive Unendlichkeit. Beispiel: 1.4 -> 2, -1.6 -> -1
floor: Rundet das Quellenfeld in Richtung negative Unendlichkeit. Beispiel: 1.6 -> 1, -1.4 -> -2
round_inf:Rundet oder schneidet das Quellfeld auf den nächsten darstellbaren Wert ab, wobei Gleichstände durch Runden positiver Werte in Richtung positive Unendlichkeit und negativer Werte in Richtung negative Unendlichkeit umgewandelt werden. Beispiel: 1.4 -> 1, 1.5 -> 2, -1.4 -> -1, -1.5 -> -2
trunc_zero: Alle Nachkommastellen rechts von der äußersten rechten Nachkommastelle, die im Ziel unterstützt wird, unabhängig vom Vorzeichen verwerfen. Ist das Ziel beispielsweise eine Ganzzahl, werden alle Nachkommastellen entfernt. Wenn es sich bei dem Ziel um eine weitere Dezimalzahl mit einer kleineren Anzahl Kommastellen handelt, wird auf die Größe der Zieldezimalzahl gerundet oder abgeschnitten. Beispiel: 1,6 -> 1, -1,6 -> -1
Syntax
ds.StringToDecimal(string (string), [rtype (string)])
gibt die Zeichenfolge im Dezimalformat zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge19982.22enthält, gibt die folgende Funktion die Dezimalzahl 19982.22zurück.
ds.StringToDecimal(mylink.mystring)
Wenn mylink.mystring die Zeichenfolge "19982.2276" enthält, gibt die folgende Funktion die Dezimalzahl 19982.23zurück.
ds.StringToDecimal(mylink.mystring,"ceil")
StringToRaw
Gibt eine Zeichenfolge als Rohcodewert zurück.
Syntax
ds.StringToRaw(string (string))
gibt den entsprechenden Rohcodewert der Zeichenfolge zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge "hello" enthält, gibt die folgende Funktion den Wert "{0x68 0x65 0x6C 0x6C 0x6F}" zurück:
ds.StringToRaw(mylink.mystring)
StringToTime
Gibt eine Zeitdarstellung der angegebenen Zeichenfolge zurück.
Syntax
ds.StringToTime(string (string), [format (string)])
gibt die Zeichenfolge im Zeitwert zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge "20:06:58" enthält, gibt die Funktion die Zeit 20:06:58 zurück.
ds.StringToTime(mylink.mystring)
Wenn mylink.mystring die Zeichenfolge "20: 6:58" enthält, gibt die Funktion die Zeit 20:06:58 zurück.
ds.StringToTime(mylink.mystring,"%(h,s):%(n,s):%(s,s)")
StringToTimestamp
Gibt die angegebene Zeichenfolge im Zeitmarkenformat zurück.
Syntax
ds.StringToTimestamp(string (string), [format (string)])
gibt die Zeichenfolge im Zeitmarkenformat zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge "1958-08-08 20:06:58" enthält, gibt die Funktion die Zeitmarke 1958-08-08 20:06:58 zurück.
ds.StringToTimestamp(mylink.mystring)
Wenn mylink.mystring die Zeichenfolge "8/ 8/1958 20: 6: 58" enthält, gibt die Funktion die Zeitmarke 1958-08-08 20:06:58 zurück.
ds.StringToTimestamp(mylink.mystring, "%(d,s)/%(m,s)/%yyyy%(h,s):%(n,s):%(s,s)")
StringToUstring
Gibt eine ustring-Zeichenfolge aus der angegebenen Zeichenfolge zurück, optional unter Verwendung der angegebenen Map (andernfalls wird der Projektstandardwert verwendet).
Syntax
ds.StringToUstring(string (string), [mapname (string)])
gibt die Zeichenfolge im ustring-Format zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge "11052009" enthält, gibt die folgende Funktion die ustring-Zeichenfolge "11052009" zurück:
ds.StringToUstring(mylink.mystring)
TimestampToDate
Gibt ein Datum aus der angegebenen Zeitmarke zurück.
Syntax
ds.TimestampToDate(timestamp (timestamp))
gibt das resultierende Datum der Zeitmarke zurück.
Beispiele
Wenn mylink.mytimestamp die Zeitmarke 1958-08-18 20:06:58 enthält, gibt die folgende Funktion das Datum 1958-08-18 zurück:
ds.TimestampToDate(mylink.mytimestamp)
TimestampToDecimal
Gibt die angegebene Zeitmarke als gepackte Dezimalzahl zurück. Die Standardformatierungszeichenfolge lautet " %yyyy%mm%dd%hh%nn%ss ". Die Zeitmarke 2009-08-25 14:03:22 ist beispielsweise als Dezimalzahl 20090825140322 gespeichert. Sie können jedoch optional eine Formatierzeichenfolge angeben, die festlegt, wie das Datum in der Dezimalzahl gespeichert wird. Formatzeichenfolgen müssen ein Format angeben, das nur Zahlen enthält. Sie können beispielsweise keine Formatierungszeichenfolge wie "%yyyy/%mm/%dt%hh: %nn:%ss" angeben, da der Schrägstrich (/) und der Doppelpunkt (:) nicht in einem gepackten Dezimalwert gespeichert werden können. Die folgenden Tokens können für die Konvertierung von oder in Dezimalwerte verwendet werden:
%yyyy (four-digit year)
%yy (two-digit year)
%NNNNyy (two-digit year with cutoff)
%mm (two-digit month)
%dd (two-digit day of month)
%ddd (three-digit day of year)
%hh (two-digit hours that use 24-hour clock)
%nn (two-digit minutes)
%ss (two-digit seconds)
%ss.N (two-digit seconds, plus the number of fractional digits allowed. The number of fractional digits is from 1 - 6 inclusive).
Die Literalziffern 0 bis 9 sind ebenfalls gültig.
Wenn Ihr angegebenes Format Mikrosekunden (z. B. %ss.4) enthält, wird die Position des Dezimalzeichens im Dezimalwert abgeleitet. Die Position des Dezimalzeichens muss nicht mit der angegebenen Skala der Dezimalzahl übereinstimmen (z. B. Skala = 4).
Syntax
ds.TimestampToDecimal(timestamp (timestamp), [format (string)])
gibt die resultierende Zeitmarke im Dezimalformat zurück.
Beispiele
Wenn mylink.mytimestamp die Zeitmarke 1958-08-18 20:06:58 enthält, gibt die folgende Funktion den Dezimalwert 19580818200658 zurück:
ds.TimestampToDecimal(mylink.mytimestamp)
Wenn mylink.mytimestamp die Zeitmarke 1958-08-18 20:06:58 enthält, gibt die folgende Funktion den Dezimalwert 200658580818 zurück:
ds.TimestampToDecimal(mylink.mytimestamp, "%hh%nn%ss%yy%mm%dd")
TimestampToString
Gibt die angegebene Zeitmarke als Zeichenfolgeformat zurück
Syntax
ds.TimestampToString(timestamp (timestamp), [format (string)])
gibt die resultierende Zeitmarke im Zeichenfolgeformat zurück.
Beispiele
Wenn mylink.mytimestamp die Zeitmarke 1958-08-18 20:06:58 enthält, gibt die Funktion die Zeichenfolge "1958-08-18 20:06:58" zurück.
ds.TimestampToString(mylink.mytimestamp)
Wenn mylink.mytimestamp die Zeitmarke 1958-08-18 20:06:58 enthält, gibt die Funktion die Zeichenfolge "1 8/0 8/1 9 5 8 20:06:58" zurück:
ds.TimestampToString(mylink.mytimestamp, "%dd/%mm/%yyyy %hh:%nn:%ss")
TimestampToTime
Gibt die angegebene Zeitmarke als Zeitformat zurück.
Syntax
ds.TimestampToTime(timestamp (timestamp), [format (string)])
gibt die resultierende Zeitmarke im Zeitformat zurück.
Beispiele
Wenn mylink.mytimestamp die Zeitmarke 1958-08-18 20:06:58 enthält, gibt die Funktion die Zeit 20:06:58 zurück:
ds.TimestampToTime(mylink.mytimestamp)
TimeToString
Gibt eine Zeichenfolge aus der angegebenen Uhrzeit zurück.
Syntax
ds.TimeToString(timestamp (timestamp), [format (string)])
gibt das Ergebnis im Zeitformat zurück.
Beispiele
Wenn mylink.mytime die Zeit 20:06:58 enthält, gibt die folgende Funktion die Zeichenfolge "20:06:58" zurück:
ds.TimeToString(mylink.mytime)
Wenn mylink.mytime die Zeit 20:06:58 enthält, gibt die folgende Funktion die Zeichenfolge "58:06:20" zurück:
ds.TimeToString(mylink.mytime, "%ss:%nn:%hh")
TimeToDecimal
Gibt die angegebene Uhrzeit als gepackte Dezimalzahl zurück. Die Standardformatierungszeichenfolge lautet " %hh%nn%ss ", sodass beispielsweise die Uhrzeit 14:03:22 als Dezimalzahl 140322 gespeichert wird. Sie können jedoch optional eine Formatierzeichenfolge angeben, die festgelegt, wie die Zeit in der Dezimalzahl gespeichert wird. Mit Formatzeichenfolgen kann nur ein Format angegeben werden, das Zahlen enthält. Sie können beispielsweise keine Formatierungszeichenfolge wie "%hh:%nn:%ss" angeben, weil der Doppelpunkt (:) nicht in einem gepackten Dezimalwert gespeichert werden kann. Die folgenden Tokens können für die Konvertierung von oder in Dezimalwerte verwendet werden:
%hh (two-digit hours that use 24-hour clock)
%nn (two-digit minutes)
%ss (two-digit seconds)
%ss.N (two-digit seconds, plus the number of fractional digits allowed. The number of fractional digits is from 1 - 6 inclusive).
Die Literalziffern 0 bis 9 sind ebenfalls gültig.
Wenn Ihr angegebenes Format Mikrosekunden (z. B. %ss.4) enthält, wird die Position des Dezimalzeichens im Dezimalwert abgeleitet. Die Position des Dezimalzeichens muss nicht mit der angegebenen Skala der Dezimalzahl übereinstimmen (z. B. Skala = 4).
Syntax
ds.TimeToDecimal(time (time), [format (string)])
gibt die Zeit im Dezimalformat zurück.
Beispiele
Wenn mylink.mytime die Zeit 20:06:58 enthält, gibt die folgende Funktion den Dezimalwert 200658 zurück:
ds.TimeToDecimal(mylink.mytime)
Wenn mylink.mytime die Zeit 20:06:58 enthält, gibt die folgende Funktion den Dezimalwert 580620 zurück:
ds.TimeToDecimal(mylink.mytime, "%ss%nn%hh")
UniChar
Generiert ein einzelnes Unicode-Zeichen auf der Basis eines Dezimalwerts im Bereich von 0 bis 65535
Syntax
ds.UniChar(expression (int32))
returns: Das Ergebnis der Formatierzeichenfolge.
Beispiel
Der folgende Code gibt "õ" zurück:
ds.UniChar(0x00F5)
UniSeq
Generiert einen Dezimalwert auf der Basis eines einzelnen Unicode-Zeichens.
Syntax
ds.UniSeq(expression (string))
returns: Die entsprechende Dezimalzahl für das Unicode-Zeichen im Format int32.
Beispiel
Der folgende Code gibt 195 zurück:
ds.UniSeq("ä")
UstringToString
Gibt eine Zeichenfolge aus dem angegebenen ustring zurück, optional unter Verwendung der angegebenen Map (andernfalls wird die Projektstandardmap zugeordnet).
Syntax
ds.UstringToString(string (ustring), [mapname(string)])
gibt das Ergebnis im Zeichenfolgeformat zurück.
Beispiele
Wenn mylink.myustring die Zeichenfolge "11052009" enthält, gibt die folgende Funktion die Zeichenfolge "11052009" zurück:
ds.UstringToString(mylink.myustring)
Xtd
Konvertiert eine hexadezimale Zeichenfolge in eine Dezimalzeichenfolge.
Syntax
ds.Xtd(hexadecimal (string))
returns: Der entsprechende Dezimalwert für die hexadezimale Zeichenfolge.
Beispiel
Der folgende Code gibt 48879 zurück:
ds.Xtd("beef")
Ganzzahl
Gibt den ganzzahligen Teil eines Ausdrucks zurück. Alle angegebenen Rechenoperationen werden unter Verwendung der vollständigen Genauigkeit des Systems berechnet. Der Bruchteil des Werts wird abgeschnitten, nicht gerundet, und die verbleibende Ganzzahl wird zurückgegeben.
Syntax
ds.Int(expression (dfloat))
returns: Der Dezimalwert, der gerundet und in den Typ int64konvertiert wird.
Beispiel
Der folgende Code gibt 454 zurück:
ds.Int(454.95)
Der folgende Code gibt 2 zurück:
ds.Int(2.35)
Datums-und Zeitfunktionen
Verwenden Sie diese Funktionen für Daten-und Zeitfunktionen in einem Ausdruck.
Funktionen, die Datumsangaben, Uhrzeiten oder Zeitmarken in den Argumenten angeben, verwenden Zeichenfolgen mit bestimmten Formaten:
- Für ein Datum lautet das Format
%yyyy-%mm-%dd. - Für eine Zeit ist das Format
%hh:%nn:%ss. Bei einer Erweiterung um Mikrosekunden ist das Format%hh:%nn:%ss.x, wobei x die Anzahl der Dezimalstellen für die Sekunden ist. - Bei einer Zeitmarke ist das Format das Datumsformat gefolgt vom Zeitformat.
Funktionen, die die Wochentage im Argument enthalten, verwenden eine Zeichenfolge, die den Wochentag angibt. Der Tag wird als Abkürzung mit drei Buchstaben oder als vollständiger Name angegeben. Beispielsweise sind die Zeichenfolgen "thu" und "thursday" beide gültig.
CurrentDate
Gibt das Datum zurück, an dem der Job ausgeführt wird.
Syntax
ds.CurrentDate()
gibt das aktuelle Datum im Datumsformat zurück.
Beispiele
Verwenden Sie diese Funktion, um das aktuelle Datum abzurufen.
ds.CurrentDate()
CurrentTime
Gibt die Zeit zurück, zu der der Job ausgeführt wird.
Syntax
ds.CurrentTime()
returns: Die aktuelle Zeit im Zeitformat.
Beispiele
Verwenden Sie diese Funktion, um die aktuelle Uhrzeit abzurufen.
ds.CurrentTime()
CurrentTimeMS
Gibt die Uhrzeit (einschließlich Mikrosekunden) zurück, zu der der Job ausgeführt wird.
Syntax
ds.CurrentTimeMS()
gibt die aktuelle Zeit im Zeitformat, einschließlich Mikrosekunden zurück.
Beispiele
Verwenden Sie diese Funktion, um die aktuelle Zeit abzurufen und die Daten auszugeben.
ds.CurrentTimeMS()
CurrentTimestamp
Gibt eine Zeitmarke zurück, die das Datum und die Uhrzeit der Jobausführung angibt.
Syntax
ds.CurrentTimestamp()
Gibt die aktuelle Zeitmarke im Zeitmarkenformat zurück.
Beispiele
Verwenden Sie diese Funktion, um die aktuelle Zeitmarke auf die Ausgabedaten abzurufen.
ds.CurrentTimestamp()
CurrentTimestampMS
Gibt eine Zeitmarke (einschließlich Mikrosekunden) zurück, die das Datum und die Uhrzeit der Jobausführung angibt.
Syntax
ds.CurrentTimestampMS()
Gibt die aktuelle Zeitmarke im Zeitmarkenformat zurück.
Beispiele
Verwenden Sie diese Funktion, um die aktuelle Zeitmarke auf die Ausgabedaten abzurufen.
ds.CurrentTimestampMS()
Datum
Gibt einen einzelnen numerischen Wert für die Tage zurück, die zwischen dem internen Systemdatum und dem 31. Dezember 1967 (Tag 0) verstrichen sind. Alle folgenden Daten sind positive Zahlen, die die Anzahl der Tage darstellen, die seit Tag 0 verstrichen sind. Alle Daten davor sind negative Zahlen, die die Anzahl der Tage vor Tag 0 darstellen.
Syntax
ds.Date()
returns: Ergebnisdatum des Formats int.
Beispiele
Wenn das aktuelle Datum der 15. November 1967 ist, gibt der folgende Code -46 zurück. Wenn das aktuelle Datum der 15. Februar 1968 ist, gibt der folgende Code 46 zurück:
ds.Date()
DateFromDaysSince
Gibt ein Datum zurück, indem eine ganze Zahl zu einem Basisdatum addiert wird. Die ganze Zahl kann ein negativer Wert sein, um ein Datum zurückzugeben, das vor dem Referenzdatum liegt.
Syntax
ds.DateFromDaysSince(number (int32), [baseline_date_object (string)])
Rückgabewerte: ein Datum durch Hinzufügen einer ganzen Zahl zu einem Basisdatum, das der Benutzer eingibt.
Beispiele
Wenn mylink.myintcol die Ganzzahl 18250 und mylink.mydatecol das Datum 1958-08-18 enthält, sind die drei folgenden Funktionen äquivalent und geben das Datum 2008-08-05 zurück:
ds.DateFromDaysSince(18250,"1958-08-18")
ds.DateFromDaysSince(mylink.myintcol,"1958-08-18")
ds.DateFromDaysSince(mylink.myintcol,mylink.mydatecol)
Wenn ' mylink.mynegintcol die ganze Zahl -1 und ' mylink.mydatecol das Datum 1958-08-18 enthält, dann sind die folgenden drei Funktionen äquivalent und geben das Datum 1958-08-17 zurück:
ds.DateFromDaysSince(-1,"1958-08-18")
ds.DateFromDaysSince(mylink.mynegintcol,"1958-08-18")
ds.DateFromDaysSince(mylink.mynegintcol,mylink.mydatecol)
DateFromDaysSince2
Gibt ein Datum zurück, indem eine ganze Zahl zu einem Basisdatum addiert wird. Die ganze Zahl kann ein negativer Wert sein, um ein Datum zurückzugeben, das vor dem Referenzdatum liegt.
Syntax
ds.DateFromDaysSince2(number (int32), [baseline_date_object (date)])
Rückgabewerte: ein Datum durch Hinzufügen einer ganzen Zahl zu einem Basisdatum, das der Benutzer eingibt.
Beispiele
Wenn mylink.myint die Ganzzahl 18250 und mylink.mydate das Datum 1958-08-18 enthält, sind die drei folgenden Funktionen äquivalent und geben das Datum 2008-08-05 zurück:
ds.DateFromDaysSince2(18250,"1958-08-18")
ds.DateFromDaysSince2(mylink.myint,"1958-08-18")
ds.DateFromDaysSince2(mylink.myint, mylink.mydate)
Wenn ' mylink.mynegint die ganze Zahl -1 und ' mylink.mydate das Datum 1958-08-18 enthält, dann sind die folgenden drei Funktionen äquivalent und geben das Datum 1958-08-17 zurück:
ds.DateFromDaysSince2(-1,"1958-08-18")
ds.DateFromDaysSince2(mylink.mynegint,"1958-08-18")
ds.DateFromDaysSince2(mylink.mynegint, mylink.mydate)
DateFromComponents
Gibt ein Datum mit den angegebenen Werten für Jahr, Monat und Tag im Monat zurück, die als drei separate Werte angegeben werden.
Syntax
ds.DateFromComponents(years (int32), months (int32), dayofmonth (int32))
returns: Ein einzelnes Datum mit den angegebenen Werten.
Beispiele
Wenn mylink.year den Wert 2010, mylink.month den Wert 12 und mylink.dayofmonth den Wert 2 enthält, sind die beiden folgenden Funktionen äquivalent und geben das Datum 2010-12-02 zurück.
ds.DateFromComponents(2010, 12, 2)
ds.DateFromComponents(mylink.year, mylink.month, mylink.dayofmonth)
DateFromJulianDay
Gibt ein Datum für die angegebene Tageszahl des julianischen Kalenders zurück.
Syntax
ds.DateFromJulianDay(julianday (uint32))
gibt das Datum des angegebenen Julianischen Tageswerts zurück.
Beispiele
Wenn mylink.myjul den Wert 2454614 enthält, sind die beiden folgenden Funktionen äquivalent und geben das Datum 2008-05-27 zurück.
ds.DateFromJulianDay(2454614)
ds.DateFromJulianDay(mylink.myjul)
DateOffsetByComponents
Gibt das angegebene Datum mit den angegebenen Offsets für Jahr, Monat und Tag im Monat zurück, die als drei separate Werte angegeben werden. Die Offsetwerte können jeweils positiv, null oder negativ sein.
Syntax
ds.DateOffsetByComponents(basedate (date), year_offset (int32), month_offset (int32), dayofmonth_offset (int32))
returns: Der angegebene Datumsversatz des Formats 'date'.
Beispiele
Wenn mylink.basedate 2011-08-18 und mylink.yearos den Wert 2, mylink.monthos den Wert 0 und mylink.dayofmonthosol den Wert 0 enthält, sind die beiden folgenden Funktionen äquivalent und geben das Datum 2013-08-18 zurück.
ds.DateOffsetByComponents("2011-08-18", 2, 0, 0)
ds.DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos)
Wenn " mylink.basedate den Wert 2011-08-18 und " mylink.yearos den Wert -2, " mylink.monthos den Wert 0 und " mylink.dayofmonthosol den Wert 0 enthält, dann sind die beiden folgenden Funktionen gleichwertig und geben das Datum 2009-08-18 zurück.
ds.DateOffsetByComponents("2011-08-18", -2, 0, 0)
ds.DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos)
Tag
Gibt den Tag des Monats aus dem Systemdatum zurück
Syntax
ds.Day()
Rückgabe: Tag des Monats im Format 'int'.
Beispiele
Wenn das aktuelle Datum 1967-12-31 ist, gibt der folgende Code 31 zurück.
ds.Day()
DaysSinceFromDate
Erhält ein bestimmtes Datum des Typs 'Datum' und ein Quellendatum des Typs 'Zeichenfolge' und gibt die Anzahl der Tage vom Quellendatum bis zum angegebenen Datum zurück.
Syntax
ds.DaysSinceFromDate(given_date (date), source_date_string (string))
returns: Differenz in Tagen zwischen den beiden angegebenen Datumsangaben des Typs int32.
Beispiele
Wenn mylink.mysourcedate das Datum 1958-08-18 und mylink.mygivendate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 18263 zurück.
ds.DaysSinceFromDate(mylink.mygivendate, mylink.mysourcedate)
ds.DaysSinceFromDate("2008-08-18","1958-08-18")
DaysSinceFromDate2
Verwendet ein bestimmtes Datum des Typs 'Datum' und ein Quellendatum des Typs 'Datum' und gibt die Anzahl der Tage vom Quellendatum bis zum angegebenen Datum zurück.
Syntax
ds.DaysSinceFromDate2(given_date (date), source_date_object (date))
gibt die Differenz zwischen den beiden angegebenen Tagen im int32-Format zurück.
Beispiele
Wenn mylink.mysourcedate das Datum 1958-08-18 und mylink.mygivendate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 18263 zurück.
ds.DaysSinceFromDate2(mylink.mygivendate, mylink.mysourcedate)
ds.DaysSinceFromDate2("2008-08-18","1958-08-18")
DaysInMonth
Gibt die Anzahl der Tage im Monat aus dem angegebenen Basisdatum zurück.
Syntax
ds.DaysInMonth(basedate (date))
gibt die Anzahl der Tage im Monat im int32-Format zurück.
Beispiele
Wenn mylink.mysourcedate das Datum 1958-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 31 zurück.
ds.DaysInMonth(mylink.mysourcedate)
ds.DaysInMonth("1958-08-18")
DaysInYear
Gibt die Anzahl der Tage im Jahr aus dem angegebenen Basisdatum zurück.
Syntax
ds.DaysInYear(basedate (date))
gibt die Anzahl der Tage im Jahr im int32-Format zurück.
Beispiele
Wenn 'mylink.mysourcedate' das Datum 2012-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 366 zurück:
ds.DaysInYear(mylink.mysourcedate)
ds.DaysInYear("2012-08-18")
Wenn mylink.mysourcedate das Datum 2011-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 365 zurück.
ds.DaysInYear(mylink.mysourcedate)
ds.DaysInYear("2011-08-18")
DateOffsetByDays
Gibt den angegebenen Datumsoffset mit der angegebenen Anzahl von Tagen zurück. Der Offsetwert kann positiv, null oder negativ sein.
Syntax
ds.DateOffsetByDays(basedate (date), dayoffset (int32))
gibt das Datumsobjekt mit dem entsprechenden Offset zurück.
Beispiele
Wenn mylink.basedate 2011-08-18 und mylink.dayoffset den Wert 2 enthält, sind die beiden folgenden Funktionen äquivalent und geben das Datum 2011-08-20 zurück.
ds.DateOffsetByDays("2011-08-18", 2)
ds.DateOffsetByDays(mylink.basedate, mylink.dayoffset)
Wenn mylink.basedate 2011-08-18 und mylink.dayoffset den Wert -31 enthält, sind die beiden folgenden Funktionen äquivalent und geben das Datum 2011-07-18 zurück.
ds.DateOffsetByDays("2011-08-18", -31)
ds.DateOffsetByDays(mylink.basedate, mylink.dayoffset)
HoursFromTime
Gibt die Stunden aus einer Zeitangabe zurück.
Syntax
ds.HoursFromTime(time (time))
gibt den Stundenwert im Format int8 zurück.
Beispiele
Wenn mylink.mytime die Zeit 22:30:00 enthält, sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 22 zurück.
ds.HoursFromTime(mylink.mytime)
ds.HoursFromTime("22:30:00")
JulianDayFromDate
Gibt die Tageszahl des julianischen Kalenders für das angegebene Datum zurück.
Syntax
ds.JulianDayFromDate(time (time))
gibt den julianischen Kalendertag im Format int32 des angegebenen Datums zurück.
Beispiele
Wenn mylink.mydate das Datum 2008-05-27 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2454614 zurück.
ds.JulianDayFromDate("2008-05-27")
ds.JulianDayFromDate(mylink.mydate)
MicroSecondsFromTime
Gibt die Mikrosekunden aus einer Zeitangabe zurück.
Syntax
ds.MicroSecondsFromTime(time (time))
gibt den Mikrosekundenwert der Zeit im int32-Format zurück.
Beispiele
Wenn mylink.mytime die Zeit 22:30:00.32 enthält, gibt die folgende Funktion den Wert 320000 zurück:
ds.MicroSecondsFromTime(mylink.mytime)
MidnightSecondsFromTime
Gibt die Anzahl der Sekunden von Mitternacht bis zur angegebenen Uhrzeit zurück.
Syntax
ds.MidnightSecondsFromTime(time (time))
returns: Der zweite Wert im Format int8 von Mitternacht bis zur Uhrzeit.
Beispiele
Wenn mylink.mytime die Zeit 00:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 1852 zurück:
ds.MidnightSecondsFromTime("00:30:52")
ds.MidnightSecondsFromTime(mylink.mytime)
MinutesFromTime
Gibt die Minuten aus einer Zeitangabe zurück.
Syntax
ds.MinutesFromTime(time (time))
returns: Der Minutenwert der Zeit im Format int8 .
Beispiele
Wenn mylink.mytime die Zeit 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 30 zurück:
ds.MinutesFromTime("22:30:52")
ds.MinutesFromTime(mylink.mytime)
MonthDayFromDate
Gibt den Tag im Monat für das angegebene Datum zurück.
Syntax
ds.MonthDayFromDate(date (date))
returns: Der Tag des Monats ab dem angegebenen Datum im Format int8 .
Beispiele
Wenn mylink.mydate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 18 zurück:
ds.MonthDayFromDate("2008-08-18")
ds.MonthDayFromDate(mylink.mydate)
MonthFromDate
Gibt die Monatszahl für das angegebene Datum zurück.
Syntax
ds.MonthFromDate(date (date))
returns: Zahl des Monats im Format int8.
Beispiele
Wenn mylink.mydate das Datum 2008-08-18 enthält, geben die beiden folgenden Funktionen beide den Wert 8 zurück:
ds.MonthFromDate("2008-08-18")
ds.MonthFromDate(mylink.mydate)
WeekdayFromDate
Gibt die Nummer des Wochentags seit dem angegebenen Datum zurück. Sie können den Tag angeben, der als erster Tag in der Woche betrachtet wird. Wenn nicht angegeben, ist dies standardmäßig der Sonntag.
Syntax
ds.WeekdayFromDate(date (date), [origin_day (string)])
returns: Der Wochentag seit dem angegebenen Datum im Format int8 .
Beispiele
Wenn mylink.mydate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 1 zurück:
ds.WeekdayFromDate("2008-08-18")
ds.WeekdayFromDate(mylink.mydate)
Wenn mylink.mydate das Datum 2008-08-18 und mylink.origin_day "saturday" enthält, sind die folgenden Funktionen äquivalent und geben den Wert 2 zurück:
ds.WeekdayFromDate("2008-08-18", "saturday")
ds.WeekdayFromDate("2008-08-18", "sat")
ds.WeekdayFromDate(mylink.mydate, mylink.origin_day)
NextWeekdayFromDate
Gibt das Datum des angegebenen Wochentags zurück, der als nächstes auf das Quellendatum folgt. Der Wochentag wird als vollständiger Name angegeben, z. B. "thursday" oder eine aus drei Buchstaben bestehende Abkürzung, z. B. "thu".
Syntax
ds.NextWeekdayFromDate(sourcedate (date), day_of_week (string))
gibt den Tag des Monats ab dem angegebenen Datum zurück.
Beispiele
Wenn mylink.mysourcedate das Datum 2008-08-18 enthält und der angegebene Wochentag Donnerstag ist, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2008-08-21 zurück:
ds.NextWeekdayFromDate("2008-08-18", "thursday")
ds.NextWeekdayFromDate(mylink.mysourcedate, "thu")
NthWeekdayFromDate
Gibt das Datum des angegebenen Wochentags mit Offset um die angegebene Anzahl Wochen ab dem Quellendatum zurück. Der Wochentag wird als vollständiger Name (z. B. thursday für Donnerstag) oder als aus drei Buchstaben bestehende Abkürzung (z. B. thu) angegeben. Die Offsetwerte können positiv, negativ oder null sein.
Syntax
ds.NthWeekdayFromDate(basedate (date), day_of_week (string), week_offset (int32))
gibt das Datum des angegebenen Wochentags um Wochen vom angegebenen Datum versetzt zurück.
Beispiele
Wenn mylink.mydate das Datum 2009-08-18 enthält und Donnerstag mit einem Offset von 1 angegeben wird, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2009-08-20 zurück. Das erste Vorkommen von Donnerstag wird zurückgegeben. Im folgenden Beispiel kommt 'Thursday' in derselben Woche wie das Datum 2009-08-18 vor. Das Datum 2009-08-18 ist ein Dienstag (Tuesday).
ds.NthWeekdayFromDate("2009-08-18", "thursday", 1)
ds.NthWeekdayFromDate(mylink.mydate, "thu", 1)
Wenn " mylink.mydate das Datum 2009-08-18 enthält und Donnerstag mit einem Offset von -2 angegeben wird, sind die beiden folgenden Funktionen gleichwertig und geben den Wert 2009-08-06 zurück. Das Vorkommen des Donnerstags, der zwei Donnerstage zurückliegt, wird zurückgegeben.
ds.NthWeekdayFromDate("2009-08-18", "thursday", -2)
ds.NthWeekdayFromDate(mylink.mydate, "thu", -2)
PreviousWeekdayFromDate
Gibt das Datum des angegebenen Wochentags zurück, der als nächstes vor dem Quellendatum liegt. Der Wochentag wird als vollständiger Name angegeben, z. B. "thursday" oder eine aus drei Buchstaben bestehende Abkürzung, z. B. "thu".
Syntax
ds.PreviousWeekdayFromDate(sourcedate (date), day_of_week (string))
gibt das Datum des letzten Wochentags ab dem angegebenen Datum zurück.
Beispiele
Wenn mylink.mysourcedate das Datum 2008-08-18 enthält und Donnerstag angegeben ist, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2008-08-14 zurück:
ds.PreviousWeekdayFromDate("2008-08-18", "thursday")
ds.PreviousWeekdayFromDate(mylink.mysourcedate, "thu")
SecondsFromTime
Gibt den zweiten Teil einer Zeit zurück
Syntax
ds.SecondsFromTime(time (time))
Gibt den zweiten Wert der Zeit im dfloat-Format zurück.
Beispiele
Wenn mylink.mytime die Zeit 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 52 zurück:
ds.SecondsFromTime("22:30:52")
ds.SecondsFromTime(mylink.mytime)
SecondsSinceFromTimestamp
Gibt die Anzahl der Sekunden zwischen zwei Zeitmarkenobjekten zurück.
Syntax
ds.SecondsSinceFromTimestamp(timestamp (timestamp), timestamp_base_string (string))
returns: Der zweite Wert im Format 'dfloat'.
Beispiele
Wenn mylink.mytimestamp die Zeitmarke 2008-08-18 22:30:52enthält und mylink.mytimestamp_base die Zeitmarke 2008-08-19 22:30:52, sind die beiden folgenden Funktionen äquivalent und geben den Wert -86400 zurück:
ds.SecondsSinceFromTimestamp("2008-08-18 22:30:52","2008-08-19 22:30:52")
ds.SecondsSinceFromTimestamp(mylink.mytimestamp, mylink.mytimestamp_base)
SecondsSinceFromTimestamp2
Gibt die Anzahl der Sekunden zwischen zwei Zeitmarkenobjekten zurück.
Syntax
ds.SecondsSinceFromTimestamp2(timestamp (timestamp), timestamp_base_object (timestamp))
returns: Der zweite Wert im Format 'dfloat'.
Beispiele
Wenn mylink.mytimestamp die Zeitmarke 2008-08-18 22:30:52enthält und mylink.mytimestamp_base die Zeitmarke 2008-08-19 22:30:52, sind die beiden folgenden Funktionen äquivalent und geben den Wert -86400 zurück:
ds.SecondsSinceFromTimestamp2("2008-08-18 22:30:52","2008-08-19 22:30:52")
ds.SecondsSinceFromTimestamp2(mylink.mytimestamp, mylink.mytimestamp_base)
Zeit
Gibt einen Zeichenfolgewert zurück, der die interne Uhrzeit ausdrückt. Die interne Zeit ist die Anzahl der Sekunden, die seit Mitternacht bis zum Tausendstel einer Sekunde (Ortszeit) vergangen sind.
Syntax
ds.Time()
returns: Die Ergebniszeit der Formatierzeichenfolge.
Beispiele
Wenn die aktuelle Zeit 11:17:43:19 ist, gibt der folgende Code 40663.842: zurück
ds.Time()
TimeDate
Gibt die Systemzeit und das Systemdatum als formatierte Zeichenfolge zurück.
Syntax
ds.TimeDate()
gibt die Systemzeit und das Datum im Zeichenfolgeformat zurück.
TimeFromComponents
Gibt eine Datumstypzeit aus den angegebenen Stunden, Minuten, Sekunden und Mikrosekunden als int32zurück.
Syntax
ds.TimeFromComponents(hours (int32), minutes (int32), seconds (int32), microseconds (int32))
returns: Die Zeit im Datumstyp.
Beispiele
Wenn mylink.hourcol den Wert 10 enthält, mylink.mincol den Wert 12, mylink.seccol den Wert 2 und mylink.mseccol 0, sind die beiden folgenden Funktionen äquivalent und geben die Zeit 10:12:02 zurück:
ds.TimeFromComponents(10, 12, 2, 0)
ds.TimeFromComponents(mylink.hourcol, mylink.mincol, mylink.seccol, mylink.mseccol)
TimeFromMidnightSeconds
Gibt die Systemzeit im Zeitformat zurück
Syntax
ds.TimeFromMidnightSeconds(seconds (time))
returns: Die Sekunden seit Mitternacht im Zeitformat.
Beispiele
Wenn mylink.mymidnightseconds den Wert 240 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 00:04:00 zurück:
ds.TimeFromMidnightSeconds(240)
ds.TimeFromMidnightSeconds(mylink.mymidnightseconds)
TimeOffsetByComponents
Gibt die Uhrzeit für die Basiszeit unter Berücksichtigung der Offsets für Stunden, Minuten und Sekunden zurück, die als separate Werte angegeben sind. Der Offset für Sekunden kann Sekundenbruchteile enthalten.
Syntax
ds.TimeOffsetByComponents(basetime (time), hour_offset (int32), minute_offset (int32), second_offset (dfloat))
gibt das Offset nach angegebenen Werten zurück.
Beispiele
Wenn mylink.basetime 14:05:29 und mylink.houros den Wert 2, mylink.minos den Wert 0 und mylink.secos den Wert 20 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeit 16:05:49 zurück.
ds.TimeOffsetByComponents("14:05:29", 2, 0, 20)
ds.TimeOffsetByComponents(mylink.basetime, mylink.houros, mylink.minos, mylink.secos)
TimeOffsetBySeconds
Gibt die Uhrzeit für die Basiszeit unter Berücksichtigung des Offsets für Sekunden zurück. Der Offset für Sekunden kann Sekundenbruchteile enthalten.
Syntax
ds.TimeOffsetBySeconds(basetime (time), second_offset (dfloat))
returns: Die Zeit mit Sekunden, die um den angegebenen Wert versetzt wurde.
Beispiele
Wenn mylink.basetime 14:05:29.30 und mylink.secos den Wert 2.5enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeit 14:05:31 zurück:
ds.TimeOffsetBySeconds("14:05:29.30", 2.5)
ds.TimeOffsetBySeconds(mylink.basetime, mylink.secos)
TimestampFromDateTime
Gibt eine Zeitmarke aus dem angegebenen Datum und der angegebenen Uhrzeit zurück.
Syntax
ds.TimestampFromDateTime(date (date), time (time))
gibt die Zeitmarke des angegebenen Datums und der angegebenen Uhrzeit zurück.
Beispiele
Wenn mylink.mydate das Datum 2008-08-18 und mylink.mytime die Zeit 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2008-08-18 22:30:52 zurück:
ds.TimestampFromDateTime("2008-08-18","22:30:52")
ds.TimestampFromDateTime(mylink.mydate, mylink.mytime)
TimestampFromSecondsSince
Gibt eine Zeitmarke zurück, die aus der Anzahl Sekunden des Basiszeitmarkenobjekts abgeleitet wird.
Syntax
ds.TimestampFromSecondsSince(seconds (dfloat), [base_timestamp_object (string)])
returns: Die Zeitmarke, die aus dem angegebenen Wert von Sekunden abgeleitet wird.
Beispiele
Wenn mylink.myseconds den Wert 2563 und mylink.timestamp_base die Zeitmarke 2008-08-18 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2008-08-18 23:13:35 zurück:
ds.TimestampFromSecondsSince(2563,"2008-08-18 22:30:52")
ds.TimestampFromSecondsSince(mylink.myseconds,mylink.timestamp_base)
TimestampFromSecondsSince2
Gibt eine Zeitmarke zurück, die aus der Anzahl Sekunden des Basiszeitmarkenobjekts abgeleitet wird.
Syntax
ds.TimestampFromSecondsSince2(seconds (dfloat), [base_timestamp_object (timestamp)])
returns: Die Zeitmarke, die aus dem angegebenen Wert von Sekunden abgeleitet wird.
Beispiele
Wenn mylink.myseconds den Wert 2563 und mylink.timestamp_base die Zeitmarke 2008-08-18 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2008-08-18 23:13:35 zurück:
ds.TimestampFromSecondsSince2(2563,"2008-08-18 22:30:52")
ds.TimestampFromSecondsSince2(mylink.myseconds, mylink.timestamp_base)
TimestampFromTimet
Gibt eine Zeitmarke aus dem angegebenen UNIX-Zeichenfolgewert time_t zurück.
Syntax
ds.TimestampFromTimet(timet_string (int32))
returns: Die Zeitmarke, die aus dem angegebenen Wert von Sekunden abgeleitet wird.
Beispiele
Wenn mylink.mytimet den Wert 1234567890 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2009-02-13 23:31:30 zurück:
ds.TimestampFromTimet(1234567890)
ds.TimestampFromTimet(mylink.mytimet)
TimestampFromTime2
Gibt eine Zeitmarke aus den angegebenen Zeit- und Zeitmarkenobjekten zurück. Der Wert im Zeitobjekt überschreibt den Zeitwert im Zeitmarkenobjekt, sodass nur der Datumsteil aus der Zeitmarke verwendet wird.
Syntax
ds.TimestampFromTime2(time (time), timestamp (timestamp))
gibt die Zeitmarke aus den angegebenen Zeit- und Zeitmarkenobjekten zurück.
Beispiele
Wenn mylink.mytime die Zeit 12:03:22 enthält und mylink.mytimestamp die Zeitmarke 2008-08-18 22:30:52, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2008-08-18 12:03:22 zurück:
ds.TimestampFromTime2("12:03:22", "2008-08-18 22:30:52")
ds.TimestampFromTime2(mylink.mytime, mylink.mytimestamp)
TimestampOffsetByComponents
Gibt die Zeitmarke mit den angegebenen Offsets aus der Basiszeitmarkenzeichenfolge für Jahr, Monat, Tag, Stunde, Minute und Sekunde zurück, die jeweils als separate Werte angegeben werden. Der Offset für Sekunden kann Sekundenbruchteile enthalten.
Syntax
ds.TimestampOffsetByComponents(basetimestamp (timestamp), year_offset (int32), month_offset (int32), dayofmonth_offset (int32), hour_offset (int32), minute_offset (int32), second_offset (dfloat))
gibt das Zeitmarkenoffset nach angegebenen Werten zurück.
Beispiele
Wenn " mylink.basetimestamp den Wert 2009-08-18 14:05:29 und " mylink.yearos den Wert 0, " mylink.monthos den Wert 2, " mylink.dayos den Wert -4, " mylink.houros den Wert 2, " mylink.minos den Wert 0 und " mylink.secos den Wert 20 enthält, dann sind die beiden folgenden Funktionen äquivalent und liefern den Zeitstempel 2009-10-14 16:05:49.
ds.TimestampOffsetByComponents("2009-08-18 14:05:29", 0, 2, -4, 2, 0, 20)
ds.TimestampOffsetByComponents(mylink.basetimestamp, mylink.houros,
mylink.minos, mylink.secos)
TimestampOffsetBySeconds
Gibt die Zeitmarke mit den angegebenen Offsets aus der Basiszeitmarkenzeichenfolge für Sekunden zurück. Der Offset für Sekunden kann Sekundenbruchteile enthalten.
Syntax
ds.TimestampOffsetBySeconds(basetimestamp (timestamp), second_offset (dfloat))
returns: Zeitmarken-Offset um angegebene Werte im Zeitmarkenformat.
Beispiele
Wenn mylink.basetimestamp 2009-08-18 14:05:29 und mylink.secos den Wert 32760 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2009-08-18 23:11:29 zurück:
ds.TimestampOffsetBySeconds("2009-08-18 14:05:29", 32760)
ds.TimestampOffsetBySeconds(mylink.basetimestamp, mylink.secos)
TimetFromTimestamp
Gibt einen UNIX-time_t-Wert aus der angegebenen Zeitmarke zurück.
Syntax
ds.TimetFromTimestamp(timestamp (timestamp))
returns: UNIX-time_t nach angegebener Zeitmarke im Format int32 .
Beispiele
Wenn mylink.mytimestamp den Wert 2009-02-13 23:31/30 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 1234567890 zurück:
ds.TimetFromTimestamp("2009-02-13 23:31:30")
ds.TimetFromTimestamp(mylink.mytimestamp)
YeardayFromDate
Gibt die Tageszahl im Jahr aus dem angegebenen Datum zurück.
Syntax
ds.YeardayFromDate(date (date))
gibt den Kalendertag im int16-Format zurück.
Beispiele
Wenn mylink.mydate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 231 zurück:
ds.YeardayFromDate("2008-08-18")
ds.YeardayFromDate(mylink.mydate)
YearFromDate
Gibt das Jahr aus dem angegebenen Datum zurück.
Syntax
ds.YearFromDate(date (date))
gibt die Jahreszahl im int16-Format zurück.
Beispiele
Wenn mylink.mydate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2008 zurück:
ds.YearFromDate("2008-08-18")
ds.YearFromDate(mylink.mydate)
YearweekFromDate
Gibt die Nummer der Woche im Jahr aus dem angegebenen Datum zurück.
Syntax
ds.YearweekFromDate(date (date))
gibt die Woche im int16-Format zurück.
Beispiele
Wenn mylink.mydate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 33 zurück:
ds.YearweekFromDate("2008-08-18")
ds.YearweekFromDate(mylink.mydate)
Monat
Gibt den aktuellen Monat zurück.
Syntax
ds.Month()
returns: Der aktuelle Monat.
Beispiele
Der folgende Code gibt den aktuellen Monat im int-Format zurück.
ds.Month()
Jahr
Gibt das aktuelle Jahr zurück
Syntax
ds.Year()
returns: Das aktuelle Jahr im int-Format.
Beispiele
Der folgende Code gibt das aktuelle Jahr zurück.
ds.Year()
Operatorfunktionen
Die Operatorfunktionen vergleichen zwei Objekte und geben einen booleschen Wert (true oder false) zurück:
Entspricht
Vergleicht, ob zwei Objekte identisch sind.
Syntax
ds.EQ(object1 (any), object2 (any))
returns: 'true', wenn der Objektwert gleich ist; andernfalls 'false'.
Beispiele
Die folgenden Ausdrücke geben den Wert 'true' für wahr zurück:
ds.EQ(null,null)
ds.EQ(true,true)
ds.EQ("1",1)
ds.EQ("1",1.0)
Die folgenden Ausdrücke geben ' false' zurück:
ds.EQ(1,null)
ds.EQ(false,true)
ds.EQ("a","b")
Ungleich
Vergleicht, wenn zwei Objekte nicht identisch sind.
Syntax
ds.NE(object1 (any), object2 (any))
returns: 'true', wenn der Objektwert nicht gleich ist, andernfalls 'false'.
Beispiele
Die folgenden Ausdrücke geben den Wert 'true' für wahr zurück:
ds.NE(1,null)
ds.NE(true,false)
ds.NE(false,true)
ds.NE("a","b")
Die folgenden Ausdrücke geben ' false' zurück:
ds.NE(null,null)
ds.NE(true,true)
ds.NE(false,false)
ds.NE("a","a")
Kleiner als
Nimmt zwei Objekte als Parameter und gibt 'true' zurück, wenn das erste Objekt kleiner als das zweite ist.
Syntax
ds.LT(object1 (any), object2 (any))
Gibt 'true' zurück, wenn das erste Objekt kleiner als das zweite Objekt ist, andernfalls 'false'.
Beispiele
Die folgenden Ausdrücke geben den Wert 'true' für wahr zurück:
ds.LT("a","b")
Die folgenden Ausdrücke geben ' false' zurück:
ds.LT("a","a")
ds.LT("a","b")
ds.LT("202310071855","20380727")
Größer als
Nimmt zwei Objekte als Parameter und gibt 'true' zurück, wenn das erste Objekt größer als das zweite ist.
Syntax
ds.GT(object1 (any), object2 (any))
returns: 'true', wenn das erste Objekt größer als das zweite Objekt ist, andernfalls 'false'.
Beispiele
Die folgenden Ausdrücke geben den Wert 'true' für wahr zurück:
ds.GT("b","a")
Die folgenden Ausdrücke geben ' false' zurück:
ds.GT("a","a")
ds.GT("5.12","5.123")
Größer-gleich
Verwendet zwei Objekte als Parameter und gibt 'true' zurück, wenn das erste Objekt größer-gleich dem zweiten ist.
Syntax
ds.GE(object1 (any), object2 (any))
returns: 'true', wenn das erste Objekt größer-gleich dem zweiten Objekt ist, andernfalls 'false'.
Beispiele
Die folgenden Ausdrücke geben den Wert 'true' für wahr zurück:
ds.GE(2, 1)
ds.GE("a","a")
Kleiner-gleich
Erhält zwei Objekte als Parameter und gibt "true" zurück, wenn das erste Objekt kleiner-gleich dem zweiten ist.
Syntax
ds.LE(object1 (any), object2 (any))
Gibt 'true' zurück, wenn das erste Objekt kleiner-gleich dem zweiten Objekt ist, andernfalls 'false'.
Beispiele
Die folgenden Ausdrücke geben den Wert 'true' für wahr zurück:
ds.GE(1, 2)
ds.LE("a","a") == true
Logische Funktionen
Die logischen Funktionen führen Bitoperationen durch.
BitAnd
Gibt das bitweise AND der beiden ganzzahligen Argumente zurück.
Syntax
ds.BitAnd(number1 (uint64), number2 (uint64))
gibt das bitweise AND im uint64-Format zurück.
Beispiele
Wenn mylink.mynumber1 die Zahl 352 und mylink.mynumber2 die Zahl 400 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 256 zurück:
ds.BitAnd(352,400)
ds.BitAnd(mylink.mynumber1, mylink.mynumber2)
BitCompress
Gibt die aus dem Zeichenfolgeargument erstellte ganze Zahl zurück, die eine binäre Darstellung aus Einsen und Nullen enthält.
Syntax
ds.BitCompress(string (string))
returns: Die Ergebniszahl, die durch Binärdateien im Format uint64dargestellt wird.
Beispiele
Wenn mylink.mynumber1 die Zeichenfolge "0101100000" enthält, geben die beiden folgenden Funktionen die Zahl 352 zurück:
ds.BitCompress("0101100000")
ds.BitCompress(mylink.mynumber)
BitExpand
Gibt eine Zeichenfolge zurück, die die binäre Darstellung aus Einsen und Nullen für die angegebene Ganzzahl enthält.
Syntax
ds.BitExpand(number (uint64))
gibt eine Zeichenfolge zurück, die die binäre Darstellung der ganzen Zahl enthält.
Beispiele
Wenn mylink.mynumber1 die Zahl 352 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeichenfolge "101100000" zurück:
ds.BitExpand(352)
ds.BitExpand(mylink.mynumber)
BitOr
Gibt das bitweise OR der beiden ganzzahligen Argumente zurück.
Syntax
ds.BitOr(number1 (uint64), number2 (uint64))
gibt das bitweise OR der beiden ganzzahligen Argumente zurück.
Beispiele
Wenn mylink.mynumber1 die Zahl 352 und mylink.mynumber2 die Zahl 400 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 496 zurück:
ds.BitOr(352,400)
ds.BitOr(mylink.mynumber1, mylink.mynumber2)
BitXOr
Gibt das bitweise Exclusive OR der beiden ganzzahligen Argumente zurück.
Syntax
ds.BitXOr(number1 (uint64), number2 (uint64))
gibt das Exclusive OR im uint64-Format zurück.
Beispiele
Wenn mylink.mynumber1 die Zahl 352 und mylink.mynumber2 die Zahl 400 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 240 zurück:
ds.BitXOr(352,400)
ds.BitXOr(mylink.mynumber1, mylink.mynumber2)
Nicht
Gibt das Komplement für den logischen Wert eines Ausdrucks zurück. Wenn der Wert des Ausdrucks "true" ist, gibt die Funktion Not den Wert "false" (0) zurück. Wenn der Wert des Ausdrucks 'false' ist, gibt die Funktion NOT den Wert' true ' (1) zurück. Ein numerischer Ausdruck, der als Wert 0 ausgewertet wird, gibt den logischen Wert 'false' an. Ein numerischer Ausdruck, der als Wert ungleich 0 ausgewertet wird. gibt den logischen Wert 'true' an. Eine leere Zeichenfolge hat den logischen Wert 'false'. Alle anderen Zeichenfolgeausdrücke (auch solche mit leerer Zeichenfolge, Leerzeichen oder mit der Zahl 0 und Leerzeichen) haben den logischen Wert 'true'.
Syntax
ds.Not()
gibt den Wert von complement im int8-Format zurück.
Beispiele
Wenn mylink.myexpression den Ausdruck 5-5 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 1 zurück:
ds.Not(5-5)
ds.Not(mylink.myexpression)
Wenn mylink.myexpression den Ausdruck 5+5 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 0 zurück:
ds.Not(5+5)
ds.Not(mylink.myexpression)
SetBit
Gibt eine ganze Zahl mit bestimmten Bits zurück, die auf einen bestimmten Status gesetzt sind. Dabei ist origfield der Eingabewert, für den die Aktion ausgeführt werden soll, bitlist ist eine Zeichenfolge, die eine Liste mit durch Kommas getrennten Bitnummern enthält, um den Status festzulegen, und bitstate ist entweder 1 oder 0 und gibt den Status der Bits an.
Syntax
ds.SetBit(origfield (uint64), bitlist (string), bitstate (uint8))
gibt die Zahl mit den Bits zurück, die im uint64-Format auf den angegebenen Status gesetzt sind.
Beispiele
Wenn mylink.origfield die Zahl 352, mylink.bitlist die Liste "2,4,8" und mylink.bitstate den Wert 1 enthält, sind die folgenden beiden Funktionen äquivalent und geben den Wert 494 zurück:
ds.SetBit(356,"2,4,8",1)
ds.SetBit(mylink.origfield, mylink.bitlist, mylink.bitstate)
Ja
Gibt den wahren Wert von 1 zurück.
Syntax
ds.True()
returns: Die ganze Zahl 1.
Beispiele
Der folgende Code gibt 1 zurück:
ds.True()
Falsch
Gibt den Wert 0 für ' false' zurück
Syntax
ds.False()
returns: Die ganze Zahl 0.
Beispiele
Der folgende Code gibt 0 zurück:
ds.False()
Mathmatical-Funktionen
Die mathematischen Funktionen führen mathematische Operationen durch.
Abs
Gibt den absoluten Wert für einen beliebigen numerischen Ausdruck zurück. Der absolute Wert eines Ausdrucks ist seine Magnitude ohne Vorzeichen.
Syntax
ds.Abs(numeric_expression (int32))
gibt den absoluten Wert des numerischen Ausdrucks im dfloat-Format zurück.
Beispiele
Wenn mylink.number1 die Zahl 12 und mylink.number2 die Zahl 34 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zahl 22 zurück:
ds.Abs(12-34)
ds.Abs(mylink.mynumber1-mylink.mynumber2)
Wenn mylink.number1 die Zahl 34 und mylink.number2 die Zahl 12 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zahl 22 zurück:
ds.Abs(34-12)
ds.Abs(mylink.mynumber1-mylink.mynumber2)
Acos
Berechnet den trigonometrischen Arkuskosinus eines Ausdrucks. Der Ausdruck muss ein numerischer Wert sein. Das Ergebnis wird als Bogenmaß ausgedrückt.
Syntax
ds.Acos(numeric_expression (dfloat))
gibt das resultierende Bogenmaß im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 0.707106781enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 0.7854:
ds.Acos(0.707106781)
ds.Acos(mylink.mynumber)
ACOS
Gibt den trigonometrischen Arkuskosinus des Ausdrucks zurück. Die Eingabe muss ein numerischer Wert sein. Das Ergebnis wird in Grad ausgedrückt.
Syntax
ds.ACOS(expression (float64))
returns: Der Winkel in Grad im Format float64 .
Beispiele
Der folgende Code gibt den Wert 45 zurück:
ds.ACOS(0.707106781)
Asin
Berechnet den trigonometrischen Arkussinus eines Ausdrucks. Der Ausdruck muss ein numerischer Wert sein. Das Ergebnis wird als Bogenmaß ausgedrückt.
Syntax
ds.Asin(numeric_expression (dfloat))
gibt das Ergebnis im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 0.707106781enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 0.7854:
ds.Asin(0.707106781)
ds.Asin(mylink.mynumber)
ASIN
Gibt den trigonometrischen Sinus eines Ausdrucks zurück. Eingabe ist der Winkel, der in Grad ausgedrückt wird.
Syntax
ds.ASIN(expression(float64))
returns: Der Winkel in Grad im Format float64 .
Beispiele
Der folgende Code gibt den Wert 45 zurück:
ds.ASIN(0.707106781)
Atan
Berechnet den trigonometrischen Arkustangens eines Ausdrucks. Der Ausdruck muss ein numerischer Wert sein. Das Ergebnis wird als Bogenmaß ausgedrückt.
Syntax
ds.Atan(numeric_expression (dfloat))
gibt das Ergebnis im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 135 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 1.5634zurück. Dies ist der Winkel, der einen Arkustangens von 135 hat:
ds.Atan(135)
ds.Atan(mylink.mynumber)
ATAN
Gibt den trigonometrischen Arkustangens des Ausdrucks zurück Die Eingabe muss ein numerischer Wert sein. Das Ergebnis wird in Grad ausgedrückt.
Syntax
ds.ATAN(expression(float64))
Gibt den Winkel in Grad des dfloat-Formats zurück.
Beispiele
Der folgende Code gibt den Wert 45 zurück:
ds.ATAN(1)
Atan2
Berechnet den trigonometrischen Arkustangens der beiden Eingaben. Dabei wird anhand der Vorzeichen der beiden Eingaben der Quadrant des Ergebnisses ermittelt. Die Eingaben müssen numerische Werte sein. Das Ergebnis wird als Bogenmaß ausgedrückt.
Syntax
ds.Atan2(numeric_expression (dfloat, dfloat))
gibt das Ergebnis im dfloat-Format zurück.
Beispiele
Wenn mylink.number1 die Zahl 10.0 und mylink.number2 die Zahl -10.0enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2.3562:
ds.Atan2(10.0, -10.0)
ds.Atan2(mylink.mynumber1, mylink.mynumber2)
Ceil
Berechnet den kleinsten ganzzahligen Wert, der größer-gleich dem angegebenen Dezimalwert ist.
Syntax
ds.Ceil(number (dfloat))
gibt den kleinsten ganzzahligen Wert in int32 zurück.
Beispiele
Wenn mylink.number die Zahl 2355,66 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2356 zurück:
ds.Ceil(2355.66)
ds.Ceil(mylink.mynumber)
Cos
Berechnet den trigonometrischen Kosinus eines Ausdrucks. Der Ausdruck muss ein numerischer Wert sein. Der Ausdruck muss einen numerischen Wert ergeben, der den Winkel als Bogenmaß angibt.
Syntax
ds.Cos(radians (dfloat))
gibt den Winkel im Bodenmaß des dfloat-Formats zurück.
Beispiele
Wenn mylink.number die Zahl 0,785398 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 0,7071 zurück:
ds.Cos(0.785398)
ds.Cos(mylink.mynumber)
Absatzkosten
Gibt den trigonometrischen Kosinus eines Winkels zurück. Der Ausdruck ist ein Winkel als Wert in Grad.
Syntax
ds.COS(expression(float64))
returns: Der Winkel in Grad im Format float64 .
Beispiele
Der folgende Code gibt den Wert 0.7071:
ds.COS(45)
Cosh
Berechnet den Hyperbelkosinus eines Ausdrucks. Der Ausdruck muss ein numerischer Wert sein.
Syntax
ds.Cosh(number (dfloat))
gibt den resultierenden Kosinus im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 2 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 3,7622 zurück:
ds.Cosh(2)
ds.Cosh(mylink.mynumber)
Div
Berechnet den Hyperbelkosinus eines Ausdrucks. Der Ausdruck muss ein numerischer Wert sein.
Syntax
ds.Div(dividend (dfloat), divisor (dfloat))
gibt den resultierenden Kosinus im dfloat-Format zurück.
Beispiele
Wenn mylink.dividend die Zahl 100 und mylink.divisor die Zahl 25 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 4 zurück:
ds.Div(100,25)
ds.Div(mylink.dividend, mylink.divisor)
Exp
Berechnet das Ergebnis des mit dem Wert des Ausdrucks potenzierten Basiswerts e. Der Wert von e beträgt ungefähr 2,71828. Die Auswertung des Ausdrucks muss einen numerischen Wert ergeben.
Syntax
ds.Exp(number (dfloat))
gibt das Ergebnis des mit einem bestimmten Wert potenzierten Werts e im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 5 enthält, sind die folgenden beiden Funktionen äquivalent und geben den Wert 54,5982 zurück:
ds.Exp(5-1)
ds.Exp(mylink.number-1)
Fabs
Berechnet den absoluten Wert für den angegebenen Gleitkommawert.
Syntax
ds.Fabs(number (dfloat))
gibt den absoluten Wert der Gleitkommazahl zurück.
Beispiele
Wenn mylink.number die Zahl -26,53 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 26,53 zurück:
ds.Fabs(-26.53)
ds.Fabs(mylink.number)
Untergrenze (Floor)
Berechnet den größten ganzzahligen Wert, der kleiner-gleich dem angegebenen Dezimalwert ist.
Syntax
ds.Floor(number (dfloat))
returns: Die größte ganze Zahl kleiner-gleich dem Dezimalwert im Format int32 .
Beispiele
Wenn mylink.number die Zahl 203,25 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 203 zurück:
ds.Floor(203.25)
ds.Floor(mylink.number)
Ldexp
Gibt einen DFLOAT-Wert zurück, indem die Mantisse mit 2 hoch dem Exponenten multipliziert wird.
Syntax
ds.Ldexp(mantissa (dfloat), exponent (int32))
gibt die resultierende Mantisse im dfloat-Format zurück.
Beispiele
Wenn mylink.mantissa die Zahl 2 und mylink.exponent die Zahl 3 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 16 zurück:
ds.Ldexp(2,3)
ds.Ldexp(mylink.mantissa, mylink.exponent)
Llabs
Berechnet den absoluten Wert für den angegebenen ganzzahligen Wert.
Syntax
ds.Llabs(number (integer))
gibt den absoluten Wert der angegebenen Ganzzahl als ganze Zahl ohne Vorzeichen zurück.
Beispiele
Wenn mylink.number die Zahl -26 enthält, sind die folgenden beiden Funktionen äquivalent und geben den Wert 26 zurück.
ds.Llabs(-26)
ds.Llabs(mylink.number)
Ln
Berechnet den natürlichen Logarithmus eines Ausdrucks im Basiswert e. Der Wert von e beträgt ungefähr 2,71828. Die Auswertung des Ausdrucks muss einen numerischen Wert größer als 0 ergeben.
Syntax
ds.Ln(number (dfloat))
gibt den resultierenden Logarithmus des auf e basierenden Ausdrucks zurück.
Beispiele
Wenn mylink.number die Zahl 6 enthält, sind die folgenden beiden Funktionen äquivalent und geben den Wert 1.7918: zurück:
ds.Ln(6)
ds.Ln(mylink.number)
Log10
Gibt den Logarithmus zur Basis 10 für den angegebenen Wert zurück.
Syntax
ds.Log10(number (dfloat))
Rückgabewerte: Der resultierende Logarithmus zur Basis 10 im Format dfloat.
Beispiele
Wenn mylink.number die Zahl 6 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 1.7782: zurück:
ds.Log10(6)
ds.Log10(mylink.number)
Max.
Gibt den größeren der beiden Argumentwerte zurück.
Syntax
ds.Max(number1 (int32), number2(int32))
returns: Der größere der beiden Ganzzahlen im Format int32 .
Beispiele
Wenn mylink.number1 die Zahl 6 und mylink.number1 die Zahl 101 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 101 zurück:
ds.Max(6,101)
ds.Max(mylink.number1, mylink.number2)
Minimum
Gibt das Minimum der beiden Argumentwerte zurück
Syntax
ds.Min(number1 (int32), number2(int32))
gibt die kleinere der beiden ganzen Zahlen zurück.
Beispiele
Wenn mylink.number1 die Zahl 6 und mylink.number1 die Zahl 101 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 6 zurück:
ds.Min(6,101)
ds.Min(mylink.number1, mylink.number2)
Mod
Berechnet den Modulo (Rest) von zwei Ausdrücken (Dividend, Divisor).
Syntax
ds.Mod(dividend (int32), divisor (int32))
gibt das resultierende Modulo im int32-Format zurück.
Beispiele
Wenn mylink.dividend die Zahl 115 und mylink.divisor die Zahl 25 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 15 zurück:
ds.Mod(115,25)
ds.Mod(mylink.dividend, mylink.divisor)
Neg
Negiert eine Zahl.
Syntax
ds.Neg(number (dfloat))
Rückgabewerte: Die resultierende negierte Zahl im dfloat-Format.
Beispiele
Wenn mylink.number die Zahl 123 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert -123 zurück:
ds.Neg(123)
ds.Neg(mylink.number)
Pwr
Berechnet den Wert eines Ausdrucks, der mit einem angegebenen Exponenten potenziert wird (Ausdruck, Potenz).
Syntax
ds.Pwr(expression (dfloat), power (dfloat))
returns: Die Ergebniszahl, die auf die angegebene Potenz im dfloat-Format erhöht wird.
Beispiele
Wenn mylink.expression die Zahl 2 und mylink.power die Zahl 3 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 8 zurück:
ds.Pwr(2,3)
ds.Pwr(mylink.expression, mylink.power)
Rand
Gibt eine Pseudozufallszahl zwischen 0 und 232-1 zurück.
Syntax
ds.Rand()
gibt die resultierende Zufallszahl im uint32-Format zurück.
Beispiele
Verwenden Sie diese Funktion, um eine Pseudozufallszahl zu generieren:
ds.Rand()
Zufällig
Gibt eine Pseudozufallszahl zwischen 0 und 232-1 zurück.
Syntax
ds.Random()
gibt die resultierende Zufallszahl im uint32-Format zurück.
Beispiele
Verwenden Sie diese Funktion, um eine Zufallszahl zu generieren:
ds.Random()
Rnd
Generiert eine positive oder negative Zufallszahl oder 0. Nimmt die Gesamtzahl der ganzen Zahlen als Eingabe, einschließlich 0, aus denen die Zufallszahl ausgewählt werden kann. Das heißt, wenn n der Wert von numerischer_Ausdruck ist, wird die Zufallszahl aus den Zahlen 0 bis (n-1) generiert.
Syntax
ds.Rnd(numeric_expression (int))
Rückgabewerte: eine Zufallszahl von 0 bis (numeric_expression - 1) im int-Format.
Beispiele
Der folgende Code gibt eine Zufallszahl von 0 bis 19 zurück.
ds.Rnd(20)
Sin
Berechnet den trigonometrischen Sinus eines Ausdrucks. Der Ausdruck muss ein numerischer Wert sein. Der Ausdruck muss einen numerischen Wert ergeben, der den Winkel als Bogenmaß angibt.
Syntax
ds.Sin(radians (dfloat))
gibt den resultierenden Winkel im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 0,785398 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 0,7071 zurück:
ds.Sin(0.785398)
ds.Sin(mylink.mynumber)
SIN
Gibt den trigonometrischen Sinus eines Ausdrucks zurück. Eingabe ist der Winkel, der in Grad ausgedrückt wird.
Syntax
ds.SIN(expression(float64))
Gibt den Winkel in Grad des dfloat-Formats zurück.
Beispiele
Der folgende Code gibt den Wert 0.7071:
ds.SIN(45)
Sinh
Berechnet den Hyperbelsinus eines Ausdrucks. Der Ausdruck muss ein numerischer Wert sein.
Syntax
ds.Sinh(number (dfloat))
gibt den resultierenden Sinus im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 2 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 3.6269: zurück:
ds.Sinh(2)
ds.Sinh(mylink.mynumber)
Sqrt
Berechnet die Quadratwurzel einer Zahl.
Syntax
ds.Sqrt(number (dfloat))
gibt die sich ergebende Quadratwurzel der Zahl im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 450 enthält, sind die folgenden beiden Funktionen äquivalent und geben den Wert 21,2132 zurück:
ds.Sqrt(450)
ds.Sqrt(mylink.mynumber)
Tan
Berechnet den trigonometrischen Tangens eines Ausdrucks. Der Ausdruck muss einen numerischen Wert ergeben, der den Winkel als Bogenmaß angibt.
Syntax
ds.Tan(radians (dfloat))
gibt die resultierende Tangente im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 0.7853981enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 1 zurück:
ds.Tan(0.7853981)
ds.Tan(mylink.mynumber)
TAN
Gibt die Funktion TAN zurück, um den trigonometrischen Tangens der Eingabe zurückzugeben. Die Eingabe stellt einen Winkel in Grad dar.
Syntax
ds.TAN(expression(float64))
returns: Der Winkel in Grad im Format float64 .
Beispiele
Der folgende Code gibt den Wert 1 zurück:
ds.TAN(45)
ATAN
Gibt den trigonometrischen Arkustangens des Ausdrucks zurück Die Eingabe muss ein numerischer Wert sein. Das Ergebnis wird in Grad ausgedrückt.
Syntax
ds.ATAN(expression(float64))
returns: Der Winkel in Grad im Format float64 .
Beispiele
Der folgende Code gibt den Wert 45 zurück:
ds.ATAN(1)
Tanh
Berechnet den Hyperbeltangens eines Ausdrucks. Der Ausdruck muss ein numerischer Wert sein.
Syntax
ds.Tanh(number (dfloat))
gibt die resultierende Tangente im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 2 enthält, sind die folgenden beiden Funktionen äquivalent und geben den Wert 0,964028 zurück:
ds.Tanh(2)
ds.Tanh(mylink.mynumber)
Zahlfunktionen
Verwenden Sie die Zahlenfunktionen, um die Mantisse aus einer Dezimalzahl oder einer Gleitkommazahl zu extrahieren. Die Kategorie Zahl im Ausdruckseditor enthält auch die Funktionen zur Typumsetzung, mit denen Sie Zahlen als Datentyp 'double', 'float' oder 'integer' umsetzen können.
Die Umsetzungsfunktionen AsDouble(), AsFloat()und AsInteger() verhalten sich anders als andere Umsetzungsdatenkonvertierungsfunktionen, wenn sie in Ableitungen verwendet werden, bei denen das Ergebnis eine Zeichenfolge ist. Das Verhalten liegt daran, dass der Transformer-Compiler die Funktionsergebnisse für diese Funktionen nicht in eine Zeichenfolge konvertiert.
AsDouble
Die angegebene Zahl wird als Doppelzeichen behandelt.
Syntax
ds.AsDouble(number (int, float and so on))
returns: Die Zahl im Doppelformat.
Beispiele
Im folgenden Ausdruck enthält die Eingabe mynumber eine Ganzzahl, aber die Funktion gibt ein Doppelzeichen aus. Wenn mylink.mynumber den Wert 56 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 12.963: zurück:
ds.AsDouble(56/4.32)
ds.AsDouble(mylink.mynumber/4.32)
AsFloat
Die angegebene Zahl wird als Gleitkommawert behandelt.
Syntax
ds.AsFloat(number (int, double and so on))
gibt die Nummer im Gleitkommaformat zurück.
Beispiele
Im folgenden Ausdruck enthält die Eingabe mynumber eine ganze Zahl, die Funktion gibt jedoch eine Gleitkommazahl aus. Wenn mylink.mynumber den Wert 56 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 12.963: zurück:
ds.AsFloat(56/4.32)
ds.AsFloat(mylink.mynumber/4.32)
AsInteger
Die angegebene Zahl wird als Ganzzahl behandelt. Es gibt jedoch einen Unterschied im Verhalten, wenn eine Dezimalzahl einer Ganzzahl im Vergleich zu einer Gleitkommazahl oder einer Doppelzahl zugeordnet wird, die einer Ganzzahl zugeordnet wird. Wenn die Konvertierung von Float oder Double in eine ganze Zahl erfolgt, handelt es sich um eine einfache Zuweisung an eine ganze Zahl. Bei der Dezimalzahl AsInteger()wird die Funktion gestartet und die Ausgabe auf den nächsten Wert gerundet.
Syntax
ds.AsInteger(number (float, double and so on))
gibt die Zahl im Ganzzahlformat zurück.
Beispiele
In dem folgenden Ausdruck hat der Eingabewert 12.962963 den Typ Double. Obwohl der Wert vom Typ Double ist, gibt die Funktion eine ganze Zahl aus. Daher ist es eine einfache Zuordnung zu einer Ganzzahlfunktion und gibt den Wert 12 zurück.
ds.AsInteger(12.962963)
Im folgenden Ausdruck werden die Berechnungen wie (56/4.32) als Typ 'Dezimalzahl' behandelt, und der Aufruf der Funktion AsInteger() beginnt rundet auf den nächsten Wert und gibt den Wert 13 zurück.
ds.AsInteger(56/4.32)
korrigieren
Konvertiert einen numerischen Wert in eine Gleitkommazahl mit einer angegebenen Genauigkeitszahl. Wenn die Zahl als Nullwert ausgewertet wird, wird null zurückgegeben. Der Genauigkeitswert ist ein numerischer Wert, der der Anzahl der Stellen mit Genauigkeit in der Gleitkommazahl entspricht. Die Standardgenauigkeit ist 4. Der Moduswert ist ein Flag, das angibt, wie überschüssige Ziffern verarbeitet werden. Ist der Modus entweder 0 oder nicht angegeben, werden überschüssige Ziffern abgerundet. Wenn der Modus einen anderen Wert als 0 hat, werden überzählige Ziffern abgeschnitten.
Syntax
ds.FIX(numeric_expression (string), precision (int8), mode (int32))
Rückgabewerte: Die konvertierte Anzahl von Format dfloat.
Beispiele
Der folgende Code gibt die Zahl 37.7363zurück.
ds.FIX("37.73629273")
MantissaFromDecimal
Gibt die Mantisse aus dem angegebenen Dezimalwert zurück.
Syntax
ds.MantissaFromDecimal(number (decimal))
gibt die Mantisse im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 243.7675 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 7675 zurück:
ds.MantissaFromDecimal(243.7675)
ds.MantissaFromDecimal(mylink.mynumber)
MantissaFromDFloat
Gibt die Mantisse aus dem angegebenen DFLOAT-Wert zurück.
Syntax
ds.MantissaFromDFloat(number (dfloat))
gibt die Mantisse im dfloat-Format zurück.
Beispiele
Wenn mylink.number die Zahl 1.234412000000000010E+4enthält, gibt die folgende Funktion den Wert 1 zurück:
ds.MantissaFromDFloat(mylink.mynumber)
Real
Konvertiert eine Zahl in einer Zeichenfolge ohne Genauigkeitsverlust in einen Gleitkommatyp.
Syntax
ds.Real(numeric_expression (string))
Rückgabewerte: Die konvertierte Anzahl von Format dfloat.
Beispiele
Der folgende Code gibt die Zahl 1.23zurück.
ds.Real("1.23")
Unformatierte Funktionen
Mit der Funktion Raw können Sie die Länge der Daten in einer Spalte abrufen, die Rohdaten enthält.
RawLength
Gibt die Länge einer unformatierten Zeichenfolge zurück.
Syntax
ds.RawLength(input string (string))
gibt die Länge der unformatierten Zeichenfolge im int32-Format zurück.
Beispiele
Wenn mylink.rawdata die Rohdaten aus einer Bitmap enthält, gibt die folgende Funktion die Größe der Bitmap in Byte zurück:
ds.RawLength(mylink.rawdata)
Zeichenfolgefunktionen
Verwenden Sie diese Funktionen für zeichenfolgebezogene Funktionen in einem Ausdruck.
AlNum
Überprüft, ob die angegebene Zeichenfolge ausschließlich alphanumerische Zeichen enthält.
Syntax
ds.AlNum(string (string))
gibt ein Ergebnis vom Typ int8 zurück, 1 wenn die Eingabe für den angegebenen Typ gültig ist, andernfalls 0.
Beispiel
Wenn mylink.mystring1 die Zeichenfolge "OED_75_9 *E" enthält, gibt die folgende Funktion den Wert 0 zurück (false).
ds.AlNum(mylink.mystring1)
Wenn mylink.mystring2 die Zeichenfolge "12redroses" enthält, gibt die folgende Funktion den Wert 1 zurück (true).
ds.AlNum(mylink.mystring2)
Alpha
Überprüft, ob die angegebene Zeichenfolge ausschließlich alphabetische Zeichen enthält.
Syntax
ds.Alpha(string (string))
gibt ein Ergebnis vom Typ int8 zurück, 1 wenn die Eingabe für den angegebenen Typ gültig ist, andernfalls 0.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "12redroses" enthält, gibt die folgende Funktion den Wert 0 (false) zurück:
ds.Alpha(mylink.mystring1)
Wenn mylink.mystring2 die Zeichenfolge "twelveredroses" enthält, gibt die folgende Funktion den Wert 1 (true) zurück:
ds.Alpha(mylink.mystring2)
Katzen
Verknüpft zwei Zeichenfolgen.
Syntax
ds.Cats(str1 (string), str2 (string))
returns: Die resultierende verkettete Zeichenfolge.
Beispiele
Der folgende Code gibtABC123zurück.
ds.Cats("ABC", "123")
Ändern
Ersetzt die angegebene Teilzeichenfolge in einem Ausdruck durch eine Ersetzungszeichenfolge.
Wenn das Argument für die Teilzeichenfolge eine leere Zeichenfolge ist, wird der Wert des Ausdrucksarguments zurückgegeben.
Wenn der Wert des Ersetzungsarguments eine leere Zeichenfolge ist, werden alle Vorkommen der Unterzeichenfolge ab der durch den Wert des Arguments 'begin' angegebenen Position entfernt. Wenn der Wert des Vorkommensarguments kleiner-gleich 0 ist, werden alle Vorkommen, die an der Position beginnen, die durch den Wert des Anfangsarguments angegeben wird, ersetzt. Andernfalls wird die Anzahl der Vorkommen, die ersetzt werden, durch den Wert des Vorkommensarguments angegeben, beginnend mit der Position, die durch den Wert des Beginnarguments angegeben wird. Wenn der Wert des Arguments 'begin' kleiner-gleich 1 ist, beginnt der Ersetzungsvorgang ab dem ersten Vorkommen. Andernfalls beginnt die Ersetzung an der Position, die durch den Wert des Arguments 'begin' angegeben wird.
Syntax
ds.Change(expression (string), substring (string), replacement (string), [occurrence (int32), [begin (int32)]])
gibt die neue Zeichenfolge zurück, bei der alle Unterzeichenfolgen ersetzt wurden.
Beispiele
Wenn mylink.mystring den Ausdruck "aaabbbcccbbb" enthält, gibt die folgende Funktion die Zeichenfolge "aaaZZZcccZZZ" zurück:
ds.Change(mylink.mystring,"bbb","ZZZ")
Wenn mylink.mystring den Ausdruck "ABC" enthält und die Unterzeichenfolge leer ist, gibt die folgende Funktion die Zeichenfolge "ABC" zurück:
ds.Change(mylink.mystring,"","ZZZ")
Wenn mylink.mystring den Ausdruck "aaabbbcccbbb" enthält und die Ersetzung leer ist, gibt die folgende Funktion die Zeichenfolge "aaaccc" zurück:
ds.Change(mylink.mystring, "bbb", "")
CompactWhiteSpace
Gibt die Zeichenfolge zurück, nachdem zusammenhängender Leerraum jeweils zu einem einzigen Leerzeichen zusammengefasst wurde.
Syntax
ds.CompactWhiteSpace(string (string))
gibt die resultierende Zeichenkette mit reduzierten Leerzeichen zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge "too many spaces" enthält, gibt die folgende Funktion die Zeichenfolge "too many spaces" zurück:
ds.CompactWhiteSpace(mylink.mystring)
Vergleichen
Vergleicht zwei Zeichenfolgen für die Sortierung. Der Vergleich kann linksbündig (Standardeinstellung) oder rechtsbündig ausgerichtet werden. Bei einem rechtsbündigen Vergleich werden numerische Teilzeichenfolgen in den angegebenen Zeichenfolgen als Zahlen verglichen.
Die numerischen Zeichenfolgen müssen in jeder Zeichenfolge an der gleichen Zeichenposition vorkommen. Beispiel: Ein rechtsbündiger Vergleich der Zeichenfolgen AB100 und AB99 ergibt, dass AB100 größer als AB99 ist, da 100 größer als 99 ist. Ein linksbündiger Vergleich der Zeichenfolgen AC99 und AB100 ergibt, dass AC99 größer ist, da C größer als B ist.
Syntax
ds.Compare(string1 (string), string2 (string), [justification ("L" or "R")])
gibt ein Ergebnis des Typs int8, -1 zurück, wenn string1 kleiner als string2 ist, 0, wenn beide Zeichenfolgen identisch sind, 1, wenn string1 größer als string2 ist.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "AB99" und mylink.mystring2 die Zeichenfolge "AB100" enthält, gibt die folgende Funktion das Ergebnis 1 zurück:
ds.Compare(mylink.mystring1, mylink.mystring2, "L")
Wenn mylink.mystring1 die Zeichenfolge "AB99" und mylink.mystring2 die Zeichenfolge "AB100" enthält, gibt die folgende Funktion das Ergebnis -1 zurück:
ds.Compare(mylink.mystring1, mylink.mystring2, "R")
CompareNoCase
Vergleicht zwei Zeichenfolgen zum Sortieren und ignoriert deren Fälle.
Syntax
ds.CompareNoCase(string1 (string), string2 (string))
gibt das Ergebnis des Typs int8, -1, wenn string1 kleiner als string2 ist, 0, wenn beide Zeichenfolgen identisch sind, und 1, wenn string1 größer als string2 ist.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "Chocolate Cake" enthält und mylink.mystring2 die Zeichenfolge "chocolate cake", gibt die folgende Funktion das Ergebnis 0 zurück:
ds.CompareNoCase(mylink.mystring1, mylink.mystring2)
CompareNum
Vergleicht die ersten n Zeichen von zwei Zeichenfolgen, wobei n vom Benutzer angegeben wird.
Syntax
ds.CompareNum(string1 (string), string2 (string), length (int16))
gibt ein Ergebnis des Typs int8, -1 zurück, wenn string1 kleiner als string2 ist, 0, wenn beide Zeichenfolgen identisch sind, 1, wenn string1 größer als string2 ist.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "Chocolate" enthält und mylink.mystring2 die Zeichenfolge "Choccy Treat", gibt die folgende Funktion das Ergebnis 0 zurück:
ds.CompareNum(mylink.mystring1, mylink.mystring2,4)
CompareNumNoCase
Vergleicht die ersten n Zeichen von zwei Zeichenfolgen, wobei die Groß-/Kleinschreibung ignoriert wird und n vom Benutzer angegeben wird.
Syntax
ds.CompareNumNoCase(string1 (string), string2 (string), length (int16))
gibt ein Ergebnis des Typs int8, -1 zurück, wenn string1 kleiner als string2 ist, 0, wenn beide Zeichenfolgen identisch sind, 1, wenn string1 größer als string2 ist.
Beispiele
Wenn mylink.myraw die Zeichenfolge "chocolate" enthält und mylink.mystring2 die Zeichenfolge "Choccy Treat", gibt die folgende Funktion das Ergebnis 0 zurück:
ds.CompareNumNoCase(mylink.mystring1, mylink.mystring2,4)
Konvertierung
Konvertiert eine Zeichenfolge in ein angegebenes internes oder externes Speicherformat. Der Zeichenfolgeausdruck wertet die Zeichenfolge aus, die konvertiert werden soll.
In der folgenden Tabelle sind die Werte aufgeführt, die Sie für die Konvertierung angeben können. Die conv_code gibt Typen von Speicherformaten an, die an der Konvertierung beteiligt sind, und conv_mode gibt an, welches Format für die Eingabe oder Ausgabe verwendet wird. Wenn Sie "I" für conv_mode angeben, wird die Funktion ICONV() für die Konvertierung verwendet. Wenn Sie "O" für conv_mode angeben, wird die Funktion OCONV() für die Konvertierung verwendet.
Tabelle für Konvertierungswerte
conv_code |
conv_mode |
Beschreibung |
|---|---|---|
| MX | I | Konvertiert die Eingabezeichenfolge von hexadezimal in dezimal. |
| MB | I | Konvertiert die Eingabezeichenfolge von binär in dezimal. |
| MX0C | I | Konvertiert die Eingabezeichenfolge von hexadezimal in eine ASCII-Zeichenfolge. |
| MB0C | I | Konvertiert die Eingabezeichenfolge von der Binärzeichenfolge in die ASCII-Zeichenfolge. |
| MX | O | Konvertiert die Eingabezeichenfolge von dezimal in hexadezimal. |
| MB | O | Konvertiert die Eingabezeichenfolge von dezimal in binär. |
| MX0C | O | Konvertiert die Eingabezeichenfolge aus der ASCII-Zeichenfolge in hexadezimal. |
| MB0C | O | Konvertiert die Eingabezeichenfolge von der ASCII-Zeichenfolge in binär. |
Syntax
ds.Conversion(string (string), conv_code (string), conv_mode (string))
returns: Die konvertierte Zeichenfolge.
Beispiele
Wenn mylink.mystring die Zeichenfolge "1111" enthält, gibt die folgende Funktion den Wert 15 zurück:
ds.Conversion(mylink.mystring,"MB", "I")
Wenn mylink.mystring die Zeichenfolge "CDE" enthält, gibt die folgende Funktion den Wert 434445 zurück.
ds.Conversion(mylink.mystring,"MX0C", "O")
Konvertieren
Konvertiert die Zeichen der Zeichenfolge, die in dem angegebenen Ausdruck bezeichnet wird. Konvertiert die in einer Liste angegebenen Zeichen in die Zeichen, die in einer anderen Liste angegeben sind.
Syntax
ds.Convert(fromlist (string), tolist (string), expression (string))
gibt die Zeichenfolge mit den umgesetzten benannten Zeichen zurück.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "NOW IS THE TIME" enthält, gibt die folgende Funktion die Zeichenfolge "NOW YS XHE XYME" zurück:
ds.Convert("TI","XY", mylink.mystring1)
Anzahl
Zählt, wie oft eine Teilzeichenfolge in einer Zeichenfolge vorkommt.
Syntax
ds.Count(string (string), substring (string))
returns: Anzahl der Vorkommen von Unterzeichenfolgen im Format int32 .
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "chocolate drops, chocolate ice cream, chocolate bars" enthält, gibt die folgende Funktion den Wert 3 zurück:
ds.Count(mylink.mystring1, "choc")
Dcount
Zählt die Anzahl der begrenzten Felder in einer Zeichenfolge.
Syntax
ds.Dcount(string (string), delimiter (string))
returns: Anzahl der Felder mit Begrenzern im Format int32 .
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "chocolate drops, chocolate ice cream, chocolate bars" enthält, gibt die folgende Funktion den Wert 3 zurück:
ds.Dcount(mylink.mystring1,",")
DownCase
Wandelt alle Großbuchstaben in einer Zeichenfolge in Kleinbuchstaben um.
Syntax
ds.DownCase(string (string))
returns: Die resultierende Zeichenfolge in Kleinbuchstaben.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "CaMel cAsE" enthält, gibt die folgende Funktion die Zeichenfolge "camel case" zurück:
ds.DownCase(mylink.mystring1)
DQuote
Schließt eine Zeichenfolge in Anführungszeichen ein.
Syntax
ds.DQuote(string (string))
gibt die resultierende Zeichenfolge zurück, die in Anführungszeichen eingeschlossen ist.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge 'needs quotations' enthält, gibt die folgende Funktion die Zeichenfolge 'needs quotations' zurück.
ds.DQuote(mylink.mystring1)
Ereplace
Ersetzt eine Teilzeichenfolge in einem Ausdruck durch eine Ersetzungszeichenfolge.
Wenn das Argument für die Teilzeichenfolge eine leere Zeichenfolge ist, wird dem Wert des Ersetzungsarguments der Wert des Ausdrucksarguments vorangestellt. Wenn das Ersetzungsargument eine leere Zeichenfolge ist, werden alle Vorkommen der Unterzeichenfolge, die an der durch den Wert des Arguments 'begin' angegebenen Position beginnen, entfernt. Wenn der Wert des Vorkommensarguments kleiner-gleich 0 ist, werden alle Vorkommen, die mit dem Wert des Anfangsarguments beginnen, ersetzt. Andernfalls wird die Anzahl der zu ersetzenden Vorkommen durch den Wert des Vorkommensarguments ab der vom Argument 'begin' angegebenen Position ermittelt. Wenn der Wert des Arguments 'begin' kleiner-gleich 1 ist, beginnt der Ersetzungsvorgang ab dem ersten Vorkommen. Andernfalls beginnt die Ersetzung an der Position, die durch den Wert des Arguments begin angegeben wird.
Syntax
ds.Ereplace(expression (string), substring (string), replacement (string), [occurrence (int32), [begin (int32)]])
gibt die resultierende Zeichenfolge zurück, bei der alle Vorkommen der Teilzeichenfolge ersetzt wurden.
Beispiele
Wenn mylink.mystring den Ausdruck "ABC" enthält und die Unterzeichenfolge leer ist, gibt die folgende Funktion den Wert "ZZZABC" zurück:
ds.Ereplace(mylink.mystring,"","ZZZ")
Wenn mylink.mystring den Ausdruck "aaabbbcccbbb" enthält und die Ersetzung leer ist, gibt die folgende Funktion den Wert "aaaccc" zurück:
ds.Ereplace(mylink.mystring, "bbb", "")
Austausch
Ersetzt ein Zeichen in einer Zeichenfolge.
Syntax
ds.Exchange(str (string), findStr (string), replaceStr (string))
returns: Die resultierende Zeichenfolge mit ersetzten Zeichen.
Beispiele
Der folgende Code gibt Folgendes zurück: ".B.BC.
ds.Exchange("ABABC", "41", "2E")
EXTRACT
Auf den Dateninhalt eines angegebenen Felds, Werts oder Unterwerts aus einer dynamischen Feldgruppe zugreifen. Die Funktion ähnelt der Funktion REMOVE.
Die dynamische Eingabefeldgruppe darf nur CHAR (254), CHAR (253), CHAR (252) als Begrenzer und ihre Hierarchie wie zuvor geschrieben enthalten. Sie können jeweils von AM-oder FM-, VM-, SM-oder SVM-Funktionen abgerufen werden. FM ist Begrenzer für die Felder der Zeichenfolgen, VM ist Begrenzer für die Zeichenfolgewerte und SM ist Begrenzer für die Unterwerte der Zeichenfolgen.
Um mehr über ' EXTRACT zu erfahren, lesen Sie bitte die Funktion EXTRACT.
Syntax
ds.EXTRACT(str (string), field (int64), [value (int64), subvalue (int64)])
returns: Die resultierende extrahierte Zeichenfolge der Formatierzeichenfolge.
Beispiele
Die folgenden Codes geben beide zurück: "9ü3ü5" Die dynamische Feldgruppe enthält 3 Felder, die durch FM/AM getrennt sind, 2 Werte im ersten Feld, 1 Unterwert im ersten Wert usw.
ds.EXTRACT("1" + ds.FM() + "4" + ds.VM() + "9" + ds.SM() + "3" + ds.SM() + "5" + ds.FM() + "1" + ds.VM() + "0" + ds.SM() + "7" + ds.SM() + "3", 2, 2)
ds.EXTRACT("1" + ds.AM() + "4" + ds.VM() + "9" + ds.SM() + "3" + ds.SM() + "5" + ds.AM() + "1" + ds.VM() + "0" + ds.SM() + "7" + ds.SM() + "3", 2, 2)
Der folgende Code gibt eine leere Zeichenfolge zurück, da es nur 3 Felder und nicht 10 oder mehr gibt.
ds.EXTRACT("1" + ds.FM() + "4" + ds.VM() + "9" + ds.SM() + "3" + ds.SM() + "5" + ds.FM() + "1" + ds.VM() + "0" + ds.SM() + "7" + ds.SM() + "3", 10, 0, 0)
Feld
Gibt mindestens eine Teilzeichenfolge zurück, die zwischen den angegebenen Begrenzungszeichen in einer Zeichenfolge enthalten ist. Das Argument für das Vorkommen gibt an, welches Vorkommen des Begrenzungszeichens als Abschlusszeichen (Terminator) verwendet werden soll. Das Argument für die Anzahl gibt optional an, wie viele Teilzeichenfolgen zurückgegeben werden sollen.
Syntax
ds.Field(string (string), delimiter (string), occurrence (int32), [number (int32)])
gibt die entsprechende Zeichenfolge zwischen den Begrenzern zurück.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers" enthält, gibt die folgende Funktion die Zeichenfolge "chocolate ice cream" zurück:
ds.Field(mylink.mystring1,",",2)
Wenn mylink.mystring1 die Zeichenfolge "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers" enthält, gibt die folgende Funktion die Zeichenfolge "chocolate ice cream, chocolate bars" zurück:
ds.Field(mylink.mystring1,",",2,2)
FieldStore
Ändert Zeichenfolgen durch Einfügen, Löschen oder Ersetzen von Feldern, die durch eine angegebene Begrenzungszeichenfolge getrennt sind. Die Begrenzungszeichenfolge gibt die zu ändernde Zeichenfolge an und kann ein beliebiges einzelnes ASCII-Zeichen sein. Die Funktion verwendet auch die Parameter start (die Position der Eingabezeichenfolge, an der die Änderung beginnt) und number , die die Häufigkeit angibt, mit der eine neue Zeichenfolge in die Eingabezeichenfolge eingefügt wird.
Syntax
ds.FieldStore(str (string), delimiter (string), start (int8), number (int8), new_fields (string))
returns: Die geänderte Zeichenfolge der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt die Zeichenfolge A#B#C#D#5:
ds.FieldStore("1#2#3#4#5", "#", 1, 4, "A#B#C#D")
Format
Verwendet die FMT-Funktion oder einen Formatausdruck zum Formatieren von Daten für die Ausgabe. Jeder BASIC-Ausdruck kann für die Ausgabe formatiert werden, indem ihm ein Formatausdruck folgt. Details zur Syntax der Funktion Fmt finden Sie unter Funktion FMT.
Syntax
ds.Fmt(string (string), format (string))
returns: Die daraus resultierenden formatierten Daten der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt die Zeichenfolge "23-69-86" zurück:
ds.Fmt("236986","R##-##-##")
Der folgende Code gibt die Zahl "***** $555.666,898.00" zurück:
ds.Fmt("555666898","20*R2$,")
FmtDP
Konvertiert einen Mehrbytezeichensatz des Typs 'Zeichenfolge' in das Zielformat. Wenn die Globalisierung (Globalisierung) nicht aktiviert ist, funktioniert die Funktion FmtDP wie eine funktional entsprechende Fmt-Funktion. Weitere Informationen zur Syntax der Funktion FmtDP finden Sie unter FunktionFmtDP.
Syntax
ds.FmtDP(string (string), format (string), [mapname (string)])
returns: Die konvertierte Zeichenfolge der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt die Zahl 56789 zurück:
ds.FmtDP("123456789","R#5")
Aufteilung
Bricht Zeichenfolgen zum Erstellen von Unterzeichenfolgen um string ist die Zeichenfolge, die gefaltet werden soll. length ist die Länge der Unterzeichenfolgen in Zeichen.
ds.Fold(str (string), length (int8))
returns: Die resultierende gefaltete Zeichenfolge.
Der folgende Code gibt "THISþIS AþTESTFOLDEþD STRþING" zurück.
ds.Fold("THIS IS A TEST FOLDED STRING", 5)
Folddp (Ordner)
Im Globalisierungsmodus (Globalisierung) werden Zeichenfolgen gefaltet, um Unterzeichenfolgen zu erstellen, die Zeichenanzeigepositionen verwenden.
Syntax
ds.Folddp(str (string), length (int), opmap (string))
returns: Die resultierende gefaltete Zeichenfolge.
Beispiele
Der folgende Code gibt Folgendes zurück: "Für mich ist es möglich, einen Standardfehler zu finden."
ds.Folddp("这里需要 UNICODE STRING", 5, "0")
Inhalt
Sucht die Position des ersten Zeichens einer Teilzeichenfolge. Das Argument für das Vorkommen gibt an, welches Vorkommen der Teilzeichenfolge gesucht werden soll.
Syntax
ds.Index(string (string), substring (string), occurrence (int32))
returns: Ergebnis im Format int32 der Häufigkeit.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers" enthält, gibt die folgende Funktion den Wert 18 zurück:
ds.Index(mylink.mystring1,"chocolate",2)
Links
Gibt die n Zeichen ganz links einer Zeichenfolge zurück.
Syntax
ds.Left(string (string) number (int32))
gibt die n Zeichen ganz links in der Zeichenfolge zurück.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers" enthält, gibt die folgende Funktion die Zeichenfolge "chocolate" zurück:
ds.Left(mylink.mystring1,9)
Len
Gibt die Länge einer Zeichenfolge zurück (angegeben in Zeichen).
Syntax
ds.Len(string (string))
returns: Länge der Zeichenfolge im Format int32 .
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "chocolate" enthält, gibt die folgende Funktion den Wert 9 zurück:
ds.Len(mylink.mystring1)
Lendp
Gibt im Globalisierungsmodus (Globalisierungsmodus) die Länge einer Zeichenfolge mit ihren gesamten Anzeigepositionen zurück.
Syntax
ds.Lendp(str (string), opmap (string))
returns: Länge der Zeichenfolge im Format int64.
Beispiele
Der folgende Code wird zurückgegeben: 19.
ds.Lendp("这里需要 UNICODE STRING", "0")
Übereinstimmung
Synonym zu MATCHES. Wird verwendet, um einen Zeichenfolgeausdruck mit einem Muster zu vergleichen Weitere Informationen zur Syntax von ' Match finden Sie unter Match Operator.
Syntax
ds.Match(str (string), pattern (string))
returns: Das Ergebnis, ob das Muster mit der Eingabezeichenfolge im Format Boolean übereinstimmt.
Beispiele
Der folgende Code gibt ' false' zurück:
ds.Match("XYZ123AB", "3X3N")
Der folgende Code gibt 'true' zurück:
ds.Match("XYZ123AB", "3X3N...")
MatchField
Durchsucht eine Zeichenfolge und gibt den Teil davon zurück, der dem Eingabeparameter pattern entspricht. Weitere Informationen zur ' MatchField -Syntax finden Sie unter MATCH-Operator.
Syntax
ds.MatchField(str (string), pattern (string), field (int))
returns: Das Ergebnis der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt die Zeichenfolge "XYZ" zurück:
ds.MatchField("XYZ123AB", "3X3N...", 1)
Num
Gibt den Wert 1 zurück, wenn die Zeichenfolge in eine Zahl konvertiert werden kann. Andernfalls wird der Wert 0 zurückgegeben.
Syntax
ds.Num(string (string))
returns: 1, wenn die Zeichenfolge in eine Zahl konvertiert werden kann, oder gibt 0 andernfalls im Format int32 zurück.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "22" enthält, gibt die folgende Funktion den Wert 1 zurück:
ds.Num(mylink.mystring1)
Wenn mylink.mystring1 die Zeichenfolge "twenty two" enthält, gibt die folgende Funktion den Wert 0 zurück:
ds.Num(mylink.mystring1)
PadString
Gibt die mit der angegebenen Anzahl Füllzeichen aufgefüllte Zeichenfolge zurück.
Syntax
ds.PadString(string (string) padstring (string) padlength (int32))
gibt die resultierende Füllzeichenfolge zurück.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "AB175" enthält, gibt die folgende Funktion die Zeichenfolge "AB17500000" zurück.
ds.PadString(mylink.mystring1,"0",5)
ENTFERNEN
Extrahiert und gibt dynamische Feldgruppenelemente zurück, die durch Systembegrenzer getrennt sind, und gibt an, welcher Systembegrenzer gefunden wurde. Sie akzeptiert einen CHAR als Begrenzer und gibt die entsprechende Zahl zurück, die angibt, welcher Begrenzer gefunden wird.
| Zahl | Trennzeichentyp |
|---|---|
| 0 | Ende der Zeichenfolge |
| 1 | Elementmarke ASCII CHAR (255) |
| 2 | Feldmarke ASCII CHAR (254) |
| 3 | Wertmarke ASCII CHAR (253) |
| 4 | Unterwertmarkierung ASCII CHAR (252) |
| 5 | Textmarke ASCII CHAR (251) |
| 6 | ASCII CHAR (250) (Nicht verfügbar in PIOPEN-Version) |
| 7 | ASCII CHAR (249) (nicht verfügbar in PIOPEN-Version) |
| 8 | ASCII CHAR (248) (Nicht verfügbar in PIOPEN-Version) |
Weitere Informationen über die Funktion REMOVE finden Sie unter Funktion REMOVE.
Syntax
ds.REMOVE(str (string))
returns: Die resultierende Zeichenfolge mit Begrenzern, die aus der Liste der Formatierzeichenfolgen entfernt wurden, und die Zahl, die dem gefundenen Begrenzer entspricht.
Beispiele
Der folgende Code gibt ["3", "12"] zurück.
ds.REMOVE("12" + ds.VM() + "12" + ds.VM())
Rechts
Gibt die n Zeichen ganz rechts einer Zeichenfolge zurück.
Syntax
ds.Right(string (string) number (int32))
gibt die n Zeichen ganz rechts einer Zeichenfolge zurück.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "chocolate drops, chocolate ice cream, chocolate bars, chocolate dippers" enthält, gibt die folgende Funktion die Zeichenfolge "dippers" zurück:
ds.Right(mylink.mystring1,7)
Soundex
Gibt einen Code zurück, der eine Gruppe von Wörtern identifiziert, die (grob) phonetisch ähnlich sind, basierend auf dem standardmäßigen offenen Algorithmus für die SOUNDEX -Auswertung.
Syntax
ds.Soundex(string (string))
gibt den Code zurück, der eine Reihe von phonetisch gleichen Wörtern identifiziert.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "Griffin" enthält, gibt die folgende Funktion den Code "G615" zurück:
ds.Soundex(mylink.mystring1)
Wenn mylink.mystring1 die Zeichenfolge "Griphin" enthält, gibt die folgende Funktion auch den Code "G615" zurück:
ds.Soundex(mylink.mystring1)
Space
Gibt eine Zeichenfolge mit n Leerzeichen zurück.
Syntax
ds.Space(length (int32))
gibt eine Zeichenfolge von Leerzeichen mit einer angegebenen Länge zurück.
Beispiele
Wenn mylink.mylength die Zahl 100 enthält, gibt die folgende Funktion eine Zeichenfolge mit 100 Leerzeichen zurück:
ds.Space(mylink.mylength)
SQuote
Schließt eine Zeichenfolge in einfache Anführungszeichen ein.
Syntax
ds.SQuote(string (string))
gibt die Zeichenfolge zurück, die in einfache Anführungszeichen eingeschlossen ist.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge 'needs quotations' enthält, gibt die folgende Funktion die Zeichenfolge 'needs quotations' zurück.
ds.SQuote(mylink.mystring1)
Str
Wiederholt die Zeichenfolge so oft wie angegeben.
Syntax
ds.Str(string (string), repeats (int32))
gibt die resultierende Zeichenfolge n Mal wiederholt zurück.
Beispiele
Wenn mylink.mystring1 die Zeichenfolge "choc" enthält, gibt die folgende Funktion die Zeichenfolge "chocchocchocchocchoc" zurück:
ds.Str(mylink.mystring1,5)
StripWhiteSpace
Gibt die Zeichenfolge zurück, nachdem Sie alle Leerzeichen entfernt haben.
Syntax
ds.StripWhiteSpace(string (string))
gibt die Zeichenfolge ohne Leerzeichen zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge "too many spaces" enthält, gibt die folgende Funktion die Zeichenfolge "toomanyspaces" zurück:
ds.StripWhiteSpace(mylink.mystring)
Teilzeichenfolge
Gibt die angegebene Unterzeichenfolge zurück.
Wenn n angegeben wird, ruft die Funktion die letzten n Zeichen einer Zeichenfolge ab.
Wenn start und length angegeben werden, ruft die Funktion die Zeichen mit der Länge length ab der Position start einer Zeichenfolge ab.
Wenn ein Begrenzer angegeben wird, ruft die Funktion mindestens eine Unterzeichenfolge ab, die sich zwischen angegebenen Begrenzern in einer Zeichenfolge befindet. occu ist die Anzahl der Begrenzer und num die Länge der Unterzeichenfolge zwischen Begrenzern in der resultierenden Unterzeichenfolge.
Syntax
ds.Substring(string (string), n (int8))
ds.Substring(string (string), start (int8), length (int8))
ds.Substring(string (string), delimiter (string), occu (int8), num (int8))
returns: Das resultierende Unterzeichenfolgenarray der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt "ab.cd" zurück.
ds.Substring("ab.cd", ".", 1, 2)
Unterzeichenfolgen
Erstellt eine dynamische Feldgruppe, von der alle Elemente Unterzeichenfolgen der entsprechenden Elemente der dynamischen Eingabefeldgruppe sind.
Syntax
ds.Substrings(str (string), start (int8), length (int8))
returns: Die resultierende dynamische Feldgruppe mit Unterzeichenfolgen, die dem Eingabearray im Zeichenfolgeformat entsprechen.
Beispiele
Der folgende Code gibtNESýITHþ23üý50üzurück.
ds.Substrings("JONESýSMITHþ1.23ü20ý2.50ü10", 3, 20)
Abschneiden
Entfernt alle führenden und nachgestellten Leerzeichen und Tabulatorzeichen. Die Funktion reduziert darüber hinaus die Anzahl der internen Vorkommen von Leerzeichen oder Tabulatorzeichen auf eins.
Das Argument stripchar gibt optional ein Zeichen an, das kein Leerzeichen oder Tabulatorzeichen ist. Das Argument options gibt den Typ der auszuführenden Trimmoperation an und enthält mindestens einen der folgenden Werte:
A: Entfernt alle Vorkommen von stripchar.
B Entfernt vor- und nachgestellte Vorkommen von stripchar.
D Entfernt führende, abschließende und redundante Leerzeichen.
E Entfernt abschließende Leerzeichen.
F Entfernt führende Leerzeichen.
L Entfernt alle vorangestellten Vorkommen von stripchar.
R Entfernt vorangestellte, nachgestellte und redundante Vorkommen von stripchar.
T Entfernt alle nachgestellten Vorkommen von stripchar.
Syntax
ds.Trim(string (string), [stripchar (string)], [options (string)])
gibt die getrimmte Zeichenfolge zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge " Zeichenfolge mit Leerzeichen ", dann gibt die folgende Funktion die Zeichenfolge" Zeichenfolge mit Leerzeichen " zurück:
ds.Trim(mylink.mystring)
Wenn mylink.mystring die Zeichenfolge " ..Remove .. redundant .. dots .... ", gibt die folgende Funktion die Zeichenfolge "Remove.redundant.dots" zurück:
ds.Trim(mylink.mystring,".")
Wenn mylink.mystring die Zeichenfolge "Remove .. all.. dots..." enthält, gibt die folgende Funktion die Zeichenfolge "Removealldots" zurück:
ds.Trim(mylink.mystring,".","A")
Wenn mylink.mystring die Zeichenfolge "Remove .. trailing.. dots...." enthält, gibt die folgende Funktion die Zeichenfolge "Remove .. trailing.. dots" zurück:
ds.Trim(mylink.mystring,".","T")
TrimB
Entfernt alle nachgestellten Leerzeichen und Tabulatorzeichen aus einer Zeichenfolge.
Syntax
ds.TrimB(string (string))
gibt die getrimmte Zeichenfolge zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge "too many trailing spaces " enthält, gibt die folgende Funktion die Zeichenfolge "too many trailing spaces" zurück:
ds.TrimB(mylink.mystring)
TrimF
Entfernt alle führenden Leerzeichen und Tabulatorzeichen aus einer Zeichenfolge.
Syntax
ds.TrimF(string (string))
gibt die getrimmte Zeichenfolge zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge " too many leading spaces" enthält, dann gibt die folgende Funktion die Zeichenfolge "too many leading spaces" zurück:
ds.TrimF(mylink.mystring)
TrimLeadingTrailing
Entfernt alle führenden und nachgestellten Leerzeichen und Tabulatorzeichen aus einer Zeichenfolge.
Syntax
ds.TrimLeadingTrailing(string (string))
gibt die getrimmte Zeichenfolge zurück.
Beispiele
Wenn mylink.mystring die Zeichenfolge " too many spaces " enthält, gibt die folgende Funktion die Zeichenfolge "too many spaces" zurück:
ds.TrimLeadingTrailing(mylink.mystring)
UpCase
Wandelt alle Kleinbuchstaben in einer Zeichenfolge in Großbuchstaben um.
Syntax
ds.UpCase(string (string))
returns: Die resultierende Zeichenfolge in Großbuchstaben.
Beispiele
Wenn ' mylink.mystring1 die Zeichenfolge ' "CaMel ' cAsE", enthält, gibt die folgende Funktion die Zeichenfolge "CAMEL ' CASE" zurück:
ds.UpCase(mylink.mystring1)
Instant Messenger
Gibt CHAR (255) zurück. Funktioniert genauso wie AM.
Syntax
ds.IM()
Gibt Folgendes zurück: das Ergebnis CHAR (255).
Beispiele
Der folgende Code gibt ' ÿ' zurück.
ds.IM()
FM
Gibt CHAR (254) zurück.
Syntax
ds.FM()
returns: Ergebnis: CHAR (254).
Beispiele
Der folgende Code gibt 'þ' zurück.
ds.FM()
AM
Gibt CHAR (254) zurück. Funktioniert wie FM.
Syntax
ds.AM()
returns: Ergebnis: CHAR (254).
Beispiele
Der folgende Code gibt 'þ' zurück.
ds.AM()
VM
Gibt CHAR (253) zurück.
Syntax
ds.VM()
Ergibt: das resultierende CHAR (253).
Beispiele
Der folgende Code gibt 'ý' zurück:
ds.VM()
SM
Gibt CHAR (252) zurück. Funktioniert genauso wie SVM.
Syntax
ds.SM()
Gibt Folgendes zurück: das Ergebnis CHAR (252).
Beispiele
Der folgende Code gibt 'ü' zurück:
ds.SM()
SVM
Gibt CHAR (252) zurück. Funktioniert genauso wie SM.
Syntax
ds.SVM()
Gibt Folgendes zurück: das Ergebnis CHAR (252).
Beispiele
Der folgende Code gibt 'ü' zurück:
ds.SVM()
™
Gibt CHAR (251) zurück.
Syntax
ds.TM()
returns: Ergebnis: CHAR (251).
Beispiele
Der folgende Code gibt 'û' zurück.
ds.TM()
Dienstprogrammfunktionen
Die Dienstprogrammfunktionen geben verschiedene Zwecke an, die sich auf das Abrufen von Informationen zu bestimmten DataStage -Funktionen beziehen.
ElementAt
Gibt das Element in der durch den Index angegebenen Liste zurück.
Syntax
ds.ElementAt(list (object))
returns: Elementindex des Formatobjekts.
Beispiele
Der folgende Code gibt 'b' zurück:
ds.ElementAt(["a","b","c"], 1)
Der folgende Code gibt 2 zurück:
ds.ElementAt([1,2,3], 1)
GetCommandName
Erhält die Knoten-ID einer Aktivität 'Bash-Script ausführen' und ruft den Befehlsnamen der Aktivität 'Bash-Script ausführen' ab.
Syntax
ds.GetCommandName(tasks.activity_id (string))
returns: Der Befehlsname der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt den Befehlsnamen der Task run_bash_script_5zurück:
ds.GetCommandName(tasks.run_bash_script_5)
GetCommandOutput
Nimmt die Knoten-ID einer Aktivität 'Bash-Script ausführen' und ruft ihre Standardausgabe ab. Er entspricht dem CEL-Ausdruck:
tasks.<activity_id>.results.standard_output
Syntax
ds.GetCommandOutput(tasks.activity_id (string))
returns: Standardausgabe der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt die Standardausgabe der Task run_bash_script_5zurück:
ds.GetCommandOutput(tasks.run_bash_script_5)
GetErrorMessage
Wird nur in der Task in einer Ausnahmebehandlungsroutine verwendet. Die Ausgabe ist der Text der Nachricht, die als Warnung protokolliert wird, wenn die Ausnahme ausgelöst wird.
Syntax
ds.GetErrorMessage()
returns: Ergebnisnachricht der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt die Fehlernachricht einer fehlgeschlagenen Task zurück:
ds.GetErrorMessage()
GetErrorNumber
Wird nur in der Task in einem Ausnahmehandler verwendet. Die Ausgabe ist die ganze Zahl, die den Typ des gestarteten Fehlers angibt. Entweder 1 oder -1.
1 gibt an, dass die Task einen Job ausgeführt hat, der abgebrochen wurde und kein bestimmter Handler konfiguriert ist.
--1 bedeutet, dass die Aufgabe aus anderen Gründen nicht ausgeführt werden konnte.
Syntax
ds.GetErrorNumber()
Rückgabewerte: Die resultierende Ganzzahl des Formats 'int'.
Beispiele
Der folgende Code gibt die Fehlernummer des Ausnahmebehandlungsroutinentyps zurück:
ds.GetErrorNumber()
GetErrorSource
Die Ausgabe wird nur in der Task in einer Ausnahmebehandlungsroutine verwendet und ist der Phasenname der Aktivitätsstufe, die die Ausnahme ausgelöst hat.
Syntax
ds.GetErrorSource()
returns: Der Ergebniswert der Task der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt die fehlgeschlagene Task zurück:
ds.GetErrorSource()
GetJobName
Gibt den Jobnamen der Aktivität DataStage ausführen zu dem Zeitpunkt zurück, zu dem die Funktion ausgeführt wird. Er entspricht dem CEL-Ausdruck:
tasks.<activity_id>.results.job_name
Syntax
ds.GetJobName(tasks.activity_id (string))
returns: Der Jobname der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt den Jobnamen der Task run_datastage_flow_1zurück:
ds.GetJobName(tasks.run_datastage_flow_1)
GetJobNameWithInvocationId
Gibt den Jobnamen der Aktivität DataStage ausführen zu dem Zeitpunkt zurück, zu dem die Funktion mit einer Suffixaufruf-ID ausgeführt wird, wenn der Job in mehreren Instanzen ausgeführt wurde und die Jobaufruf-ID nicht leer ist.
Syntax
ds.GetJobNameWithInvocationId(tasks.nodeId)
Rückgabewerte: Der Jobname der Formatierzeichenfolge mit dem Suffix der Aufruf-ID, sofern verfügbar
Beispiele
Der folgende Code gibt rowGenPeekJob.bigloop1 mit dem Tasknamen rowGenPeekJob und der Aufruf-ID bigloop1zurück:
ds.GetJobNameWithInvocationId(tasks.rowGenPeekJob)
GetJobStatus
Erhält die Knoten-ID einer Aktivität " DataStage ausführen" und ruft ihren Jobstatus für <activity_name>.$JobStatusab. Er entspricht dem folgenden cel-Ausdruck:
((tasks.<activity_id>.results.status == 'Completed') ? 1 : ((tasks.<activity_id>.results.status == 'CompletedWithWarnings') ? 2 : ((tasks.<activity_id>.results.status == 'Cancelled') ? 96 : 3)))
Syntax
ds.GetJobStatus(tasks.activity_id (string))
returns: Der Jobstatus des Formats int.
Beispiele
Der folgende Code gibt den Status der Task run_datastage_flow_1zurück:
ds.GetJobStatus(tasks.run_datastage_flow_1)
GetListCounter
Wird in der Task nur in einer Schleife mit einem Listenzähler verwendet, ist die Ausgabe der aktuelle Wert der Zählervariablen.
Syntax
ds.GetListCounter()
returns: Der Ergebniswert des Zählers der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt den aktuellen Wert der Schleife zurück.
ds.GetListCounter()
GetNumericCounter
Wird in der Task nur in einer Schleife mit einem numerischen Zähler verwendet, ist die Ausgabe der aktuelle Wert der Zählervariablen der Schleife.
Syntax
ds.GetNumericCounter()
returns: Ergebniswert des Zählers des Formats 'int'.
Beispiele
Der folgende Code gibt den aktuellen Wert der Schleife zurück.
ds.GetNumericCounter()
GetOutputArg
Gibt den angegebenen Wert eines Schlüssels aus einer Eingabe des JSON-Typs 'string' zurück.
Syntax
ds.GetOutputArg(JSON (string), key_value (string))
returns: Der Wert des Eigenschaftsfelds.
Beispiele
Der folgende Code gibt den Zeichenfolgewert "tom" zurück:
ds.GetOutputArg("{"name":"tom"}", "name")
GetReturnValue
Erhält die Knoten-ID einer Aktivität 'Bash-Script ausführen' und gibt den Wert der Aktivität 'Bash-Script ausführen' zurück Er entspricht dem folgenden CEL-Ausdruck:
tasks.<activity_id>.results.return_value
Syntax
ds.GetReturnValue(tasks.activity_id (string))
returns: Ergebniswert der Task des Formats 'int'.
Beispiele
Der folgende Code gibt den Wert der Task tasks.run_bash_script_5zurück:
ds.GetReturnValue(tasks.run_bash_script_5)
GetUserStatus
Erhält die Kennung einer DataStage -Ablauftask und gibt den Status der DataStage -Ablauftask im Sequenzjob zurück. Die Funktion funktioniert nicht, wenn sie in einem parallelen Job ausgeführt werden. Er entspricht dem CEL-Ausdruck:
tasks.<activity_id>.results.user_status
Syntax
ds.GetUserStatus(tasks.run_datastage_id (string))
returns: Status der DataStage -Ablauftask-ID der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt den Wert der Task-ID run_datastage_5zurück:
ds.GetUserStatus(tasks.run_datastage_5)
LogName
Gibt den Anmeldenamen des aktuellen Benutzers zurück
Syntax
ds.LogName()
returns: Der Anmeldename des aktuellen Benutzers der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt den Anmeldenamen des aktuellen Benutzers zurück.
ds.LogName()
Pfad
Gibt den Pfadnamen des aktuellen Benutzers zurück.
Syntax
ds.Path()
returns: Der Pfadname des aktuellen Benutzers der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt den Pfadnamen des aktuellen Benutzers zurück.
ds.Path()
Schema
Gibt den Schemanamen des aktuellen Benutzers zurück
Syntax
ds.Schema()
returns: Der Schemaname des aktuellen Benutzers der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt den Schemanamen des aktuellen Benutzers zurück.
ds.Schema()
UserNo
Gibt die Benutzernummer des aktuellen Benutzers zurück.
Syntax
ds.UserNo()
returns: Die Benutzerinformationen des aktuellen Benutzers im Format int.
Beispiele
Der folgende Code gibt die Benutzernummer des aktuellen Benutzers zurück.
ds.UserNo()
Zielgruppe
Gibt den aktuellen Benutzer zurück.
Syntax
ds.Who()
returns: Der aktuelle Benutzer der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt den aktuellen Benutzer zurück.
ds.Who()
Funktionen zur Nullwertbehandlung
Funktionen, die Nullwertbehandlung ausführen.
IsNull
Gibt 'true' zurück, wenn der Eingabeausdruck als Nullwert ausgewertet wird.
Syntax
ds.IsNull(input (any))
returns: Das Ergebnis, ob der Ausdruck als null im Format Boolean ausgewertet wird.
Beispiele
Der folgende Code gibt 'true' zurück.
ds.IsNull(null)
Der folgende Code gibt ' false' zurück.
ds.IsNull(0)
IsNotNull
Gibt 'true' zurück, wenn der Eingabeausdruck nicht als Nullwert ausgewertet wird.
Syntax
ds.IsNotNull(input (any))
returns: Das Ergebnis, ob der Ausdruck nicht als null ausgewertet wird, im Format Boolean.
Beispiele
Der folgende Code gibt ' false' zurück.
ds.IsNotNull(null)
Der folgende Code gibt 'true' zurück.
ds.IsNotNull(0)
Null
Gibt den Nullwert zurück.
Syntax
ds.Null()
returns: Der Nullwert.
Beispiele
Der folgende Code gibt null zurück.
ds.Null()
NullToEmpty
Gibt eine leere Zeichenfolge zurück, wenn die Eingabe null ist. Andernfalls wird der Wert der Eingabespalte zurückgegeben.
Syntax
ds.NullToEmpty(input (any))
returns: Eine leere Zeichenfolge oder der Eingabewert.
Beispiele
Der folgende Code gibt "AA" zurück:
ds.NullToEmpty("AA")
Der folgende Code gibt "" zurück.
ds.NullToEmpty(null)
NullStr
Gibt die Nullzeichenfolge CHAR (128) zurück.
Syntax
ds.NullStr()
returns: Nullzeichenfolge CHAR (128).
Beispiele
Der folgende Code gibt € zurück.
ds.NullStr()
NullToValue
Gibt den angegebenen Wert zurück, wenn die Eingabe null ist. Andernfalls wird der Wert der Eingabespalte zurückgegeben.
Syntax
ds.NullToValue(input (any), default (any))
returns: Der angegebene Wert oder der Eingabewert.
Beispiele
Der folgende Code gibt "test" zurück.
ds.NullToValue("test", "default")
Der folgende Code gibt "default" zurück.
ds.NullToValue(null, "default")
Der folgende Code gibt 1 zurück.
ds.NullToValue(null, 1)
NullToZero
Gibt 0 zurück, wenn die Eingabe null ist. Andernfalls wird der Wert der Eingabespalte zurückgegeben.
Syntax
ds.NullToZero(input (any))
Gibt 0 oder den Eingabewert zurück.
Beispiele
Der folgende Code gibt 88 zurück.
ds.NullToZero(88)
Der folgende Code gibt 0 zurück.
ds.NullToZero(null)
SetNull
Weist der Zielspalte einen Nullwert zu.
Syntax
ds.SetNull()
returns: Setzt das Ziel auf den Nullwert.
Beispiele
Der folgende Code gibt null zurück.
ds.SetNull()
Makrofunktionen
Funktionen, die das Abrufen einer Gruppe von Projektmetadaten für DataStage -Sequenzjobs verarbeiten.
JobName
Gibt den Namen des Sequenzerjobs zurück.
Syntax
ds.JobName
returns: Der Sequencer-Jobname der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt den Namen des Sequenzerjobs zurück.
ds.JobName
JobStartDate
Gibt das Startdatum des Sequenzerjobs zurück.
Syntax
ds.JobStartDate
returns: Das Startdatum des Sequenzerjobs der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt das Startdatum des Sequenzerjobs zurück.
ds.JobStartDate
JobStartTime
Gibt die Startzeit des Sequenzerjobs zurück.
Syntax
ds.JobStartTime
returns: Die Startzeit des Sequenzerjobs der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt die Startzeit des Sequenzerjobs zurück.
ds.JobStartTime
JobStartTimestamp
Gibt die Startzeitmarke des Sequenzerjobs zurück.
Syntax
ds.JobStartTimestamp
returns: Die Startzeitmarke des Sequenzerjobs im Format timestamp.
Beispiele
Der folgende Code gibt die Startzeitmarke des Sequenzerjobs zurück.
ds.JobStartTimestamp
HostName
Gibt den Hostnamen des DataStage -Servers zurück
Syntax
ds.HostName
returns: Der Sequenzerjob InvocationId der Formatierzeichenfolge.
Beispiele
Der folgende Code gibt den Sequenzerjob InvocationIdzurück.
ds.HostName
ProjectName
Gibt den Projektnamen des aktiven Sequenzerjobs zurück.
Syntax
ds.ProjectName
returns: Der Projektname des aktiven Sequencer-Jobs.
Beispiele
Der folgende Code gibt den Projektnamen des aktiven Sequenzerjobs zurück.
ds.ProjectName
ProjectId
Gibt die Projekt-ID des aktiven Sequenzerjobs zurück.
Syntax
ds.ProjectId
returns: Die Projekt-ID des aktiven Sequenzerjobs.
Beispiele
Der folgende Code gibt die Projekt-ID des aktiven Sequenzerjobs zurück.
ds.ProjectId
JobId
Gibt die Job-ID des aktiven Sequenzerjobs zurück.
Syntax
ds.JobId
returns: Die Job-ID des aktiven Sequencer-Jobs.
Beispiele
Die folgenden Befehle geben die Job-ID des aktiven Sequenzerjobs zurück.
ds.JobId
JobController
Gibt den Namen des Pipeline-Ablaufs des aktiven Sequenzerjobs zurück.
Syntax
ds.JobController
returns: Der Name des Pipelineablaufs des aktiven Sequenzerjobs.
Beispiele
Die folgenden Befehle geben den Namen des Pipeline-Ablaufs des aktiven Sequenzerjobs zurück.
ds.JobController
Übergeordnetes Thema: Bedingungen zu einer Pipeline hinzufügen