Konvertierungsfunktionen im Jitterbit Design Studio
Konvertierungsfunktionen werden verwendet, um Jitterbit-Datenelemente und-Variablen von einem Typ in einen anderen zu konvertieren.
BinaryToHex
Erklärung
string BinaryToHex(binary arg)
Syntax
BinaryToHex(<arg>)
Erforderliche Parameter
arg: Zu konvertierender Binärwert
Beschreibung
Konvertiert einen Binärwert in eine Zeichenfolge, die die Hexadezimalwerte jedes Bytes darstellt. Die resultierende Zeichenfolge besteht vollständig aus Kleinbuchstaben. Das Ergebnis dieses Funktionsaufrufs ist undefiniert, wenn das Argument kein Binärwert ist.
Dies ist die Umkehrung der Funktion HexToBinary().
Beispiele
// If $x is a binary value containing the bytes
// 0x17 0xA3 0xEF 0x80
BinaryToHex($x)
// returns the string "17a3ef80"
// If $y is an empty binary value
BinaryToHex($y)
// returns an empty string ("")
BinaryToUUID
Erklärung
string BinaryToUUID(binary arg)
Syntax
BinaryToUUID(<arg>)
Erforderliche Parameter
arg: Zu konvertierender Binärwert
Beschreibung
Konvertiert einen 16-Byte-Binärwert in eine Zeichenfolge im Standard-UUID-Format. Die resultierende Zeichenfolge ist immer klein geschrieben.
Dies ist die Umkehrung der Funktion UUIDToBinary.
Beispiele
// If $x is a binary value containing the 16 bytes
// 0x2F 0x46 0xDA 0xD9 0xE5 0xC2 0x45 0x7E 0xB1 0xFD 0xAD 0x1B 0x49 0xB9 0x9A 0xFF,
BinaryToUuid($x)
// returns the string "2f46dad9-e5c2-457e-b1fd-ad1b49b99aff"
Bool
Erklärung
bool Bool(binary arg)
Syntax
Bool(<arg>)
Erforderliche Parameter
arg: Zu konvertierender Binärwert
Beschreibung
Konvertiert jeden Datentyp in einen Booleschen Wert (true oder false). Wenn die Daten eine Ganzzahl oder eine Gleitkommazahl ungleich Null sind, ist das Ergebnis true(1). Die Saiten "true" Und "T" gibt true zurück, unabhängig von Groß- und Kleinschreibung ("TRUE", "t", Und "True" alle zurück true). In allen anderen Fällen ist das Ergebnis false(0).
Beispiele
Bool(2);
// Returns true
Bool("true");
// Returns true
Bool("F");
// Returns false
Bool("text");
// Returns false
Date
Erklärung
date Date(type arg)
Syntax
Date(<arg>)
Erforderliche Parameter
arg: Wert, der in ein Datumsobjekt umgewandelt werden soll
Beschreibung
Konvertiert das Argument in ein Datum. Wenn die Eingabe eine Zeichenfolge ist, muss sie mit einem der Standarddatumsformate formatiert werden, wie z. B. "12/25/2018 12:30","2018-12-25", "2018-12-25T12:30:00","December 25, 2018", oder"DEC 25, 2018".
Wenn die Eingabezeichenfolge nicht in einem der vier vordefinierten Datumsformate vorliegt (GeneralDate, LongDate, MediumDate, oder ShortDate), die gelesen werden können von Date Funktion kann es zunächst mit der CVTDate-Funktion. Stunde, Minute und Sekunde sind optional.
Wenn die Eingabe eine Ganzzahl oder eine doppelte Zahl ist, wird die Eingabe als Anzahl der Sekunden ab 00:00:00 Uhr des 1.1.1970 UTC, dem Beginn der UNIX-Epoche, interpretiert.
Beachten Sie, dass Date(Long(Now())) == Now().
Beispiele
Date("9/27/2007");
// Returns the date that represents 2007-09-27 00:00:00 UTC
Date(1190888288);
// Returns the date that represents 2007-09-27 10:18:08 UTC
// (also known as 2007-09-27T10:18:08)
Double
Erklärung
double Double(type arg)
Syntax
Double(<arg>)
Erforderliche Parameter
arg: Zu konvertierender Wert
Beschreibung
Es wird versucht, das Argument nach bestem Wissen und Gewissen in einen Double-Wert umzuwandeln. Wenn der ausgewertete Datentyp nicht in einen Double-Wert umgewandelt werden kann, gibt die Funktion 0 zurück. Wenn es sich bei den ausgewerteten Daten um einen Datums- oder Zeitdatensatz handelt, ist das Ergebnis die Anzahl der Sekunden seit 00:00:00 Uhr des 1.1.1970 UTC (Beginn der UNIX-Epoche).
Beispiele
Double(19.9874);
// Returns a value of 19.987400
Double(9/15);
// Returns a value of 0
Double("5.5a");
// Returns a value of 5.5
Double("abcd");
// Returns 0
Double(Date("2007-09-27T10:18:08"));
// Returns 1190888288
Float
Erklärung
float Float(type arg)
Syntax
Float(<arg>)
Erforderliche Parameter
arg: Zu konvertierender Wert
Beschreibung
Es wird versucht, das Argument nach bestem Wissen und Gewissen in eine Gleitkommazahl umzuwandeln. Wenn der ausgewertete Datentyp nicht in eine Gleitkommazahl umgewandelt werden kann, gibt die Funktion 0 zurück. Wenn es sich bei den ausgewerteten Daten um einen Datums- oder Zeitdatensatz handelt, ist das Ergebnis die Anzahl der Sekunden seit 00:00:00 Uhr des 1.1.1970 UTC (dem Beginn der UNIX-Epoche).
Beispiele
Float(345);
// Returns a value of 345
Float("3.141592");
// Returns a value of 3.14159
Float("5.5a");
// Returns a value of 5.5
Float("abcd");
// Returns 0
Float("2007-09-27T10:18:08");
// Returns 1.19089e+09
HexToBinary
Erklärung
string HexToBinary(string arg)
Syntax
HexToBinary(<arg>)
Erforderliche Parameter
arg: Zu konvertierender Hex-String
Beschreibung
Konvertiert eine Hex-Zeichenfolge in einen Binärwert. Der resultierende Wert enthält die Bytes, die durch jedes Zeichenpaar in der Eingabezeichenfolge dargestellt werden. Die Eingabezeichenfolge berücksichtigt keine Groß-/Kleinschreibung.
Dies ist die Umkehrung der Funktion BinaryToHex.
Beispiele
HexToBinary("17a3ef80");
// Returns a binary value containing the bytes 0x17 0xA3 0xEF 0x80
HexToBinary("17A3EF80");
// Returns a binary value containing the bytes 0x17 0xA3 0xEF 0x80
HexToBinary("");
// Returns an empty binary value
HexToString
Erklärung
string HexToString(string arg)
Syntax
HexToString(<arg>)
Erforderliche Parameter
arg: Zu konvertierendes Hex-String-Element
Beschreibung
Konvertiert eine UTF-8-Hex-Zeichenfolge in einen Zeichenfolgenwert. Der resultierende Wert enthält die Zeichen, die durch jedes Zeichenpaar in der Eingabezeichenfolge dargestellt werden. Die Eingabezeichenfolge unterscheidet nicht zwischen Groß- und Kleinschreibung. Da die Eingabezeichen hexadezimal sind, müssen die Zeichenpaare der Eingabezeichenfolge auf den Bereich „00“ bis „FF“ beschränkt werden.
Um Null-Hex-Werte zu unterstützen (00) Konvertierung, setze jitterbit.scripting.hex.enable_null_support Zu true davorlegende dieser Funktion, wenn Sie Agent-Versionen ab 11.37 verwenden.
Um den ausgehenden String-Wert aus einem UTF-16-Hex-String zu konvertieren, setzen Sie jitterbit.scripting.hex.enable_unicode_support Zu true davorlegende dieser Funktion, wenn Agent-Versionen 10.71 / 11.9 oder höher verwendet werden.
Dies ist die Umkehrung der Funktion StringToHex.
Beispiele
HexToString("6E6577");
// Returns "new"
HexToString("00");
// Returns an empty string ("")
HexToString("c2a7");
// Returns "§" (UTF-8)
HexToString("a7");
// Returns "§" if jitterbit.scripting.hex.enable_unicode_support is set to true (UTF-16), otherwise returns "�" (UTF-8)
Int
Erklärung
int Int(type arg)
Syntax
Int(<arg>)
Erforderliche Parameter
arg: Zu konvertierender Wert
Beschreibung
Es wird versucht, das Argument nach bestem Wissen und Gewissen in eine Ganzzahl umzuwandeln. Wenn der ausgewertete Datentyp nicht in eine Ganzzahl umgewandelt werden kann, gibt die Funktion 0 zurück. Wenn es sich bei den ausgewerteten Daten um einen Datums- oder Zeitdatensatz handelt, ist das Ergebnis die Anzahl der Sekunden seit 00:00:00 Uhr des 1.1.1970 UTC (dem Beginn der UNIX-Epoche).
Beispiele
Int("3.141592");
// Returns a value of 3
Int("5a");
// Returns a value of 5
Int("5");
// Returns a value of 5
Int("abcd");
// Returns 0
Int(Date("2007-09-27 10:18:08"));
// Returns a value of 1190888288
Long
Erklärung
long Long(type arg)
Syntax
Long(<arg>)
Erforderliche Parameter
arg: Zu konvertierender Wert
Beschreibung
Es wird versucht, das Argument nach bestem Wissen und Gewissen in eine lange Ganzzahl umzuwandeln. Wenn der ausgewertete Datentyp nicht in eine lange Ganzzahl umgewandelt werden kann, gibt die Funktion 0 zurück. Wenn es sich bei den ausgewerteten Daten um einen Datums- oder Zeitdatensatz handelt, ist das Ergebnis die Anzahl der Sekunden seit 00:00:00 Uhr des 1.1.1970 UTC (dem Beginn der UNIX-Epoche).
Beispiele
Long("3.141529");
// Returns a value of 3
Long("5a");
// Returns a value of 5
Long("5");
// Returns a value of 5
Long(1234567890.123456);
// Returns a value of 1234567890
Long("abcd");
// Returns a value of 0
Long(Date("2007-09-27 10:18:08"));
// Returns a value of 1190888288
String
Erklärung
string String(type arg)
Syntax
String(<arg>)
Erforderliche Parameter
arg: Zu konvertierender Wert
Beschreibung
Konvertiert jeden Datentyp in eine Zeichenfolge. Wenn die ausgewerteten Daten bereits eine Zeichenfolge sind, findet keine Konvertierung statt.
Wenn der Datentyp ein Datums- oder Zeitdatensatz ist, wird das Datum im ISO 8601-Format (jjjj-mm-tt HH:MM:SS) zurückgegeben. Für andere Datumsformate verwenden Sie die Funktionen CVTDate oder FormatDate.
Binäre Daten, die Nullbytes enthalten, werden als Zeichenfolge zurückgegeben, die die Hexadezimalwerte jedes Bytes darstellt, genau so, als ob BinaryToHex aufgerufen wurde. Wenn die Binärdaten keine Nullbytes enthalten, wird eine Zeichenfolgendarstellung zurückgegeben, wobei davon ausgegangen wird, dass die Bytes eine UTF-8-codierte Zeichenfolge darstellen. Wenn Sie immer eine hexadezimale Darstellung wünschen, verwenden Sie die BinaryToHex Funktion stattdessen.
Für einen booleschen Wert werden die Zeichenfolgen „1“ oder „0“ zurückgegeben.
Beispiele
String("98");
// Returns a value of "98"
String(98);
// Returns a value of "98"
String(true);
// Returns a value of "1"
String(Date("2007-09-27T10:18:08"));
// Returns a value of "2007-09-27 10:18:08"
String(HexToBinary("6E6577"));
// Returns a value of "new"
StringToHex
Erklärung
string StringToHex(string arg)
Syntax
StringToHex(<arg>)
Erforderliche Parameter
arg: Zu konvertierendes String-Element
Beschreibung
Konvertiert einen String-Wert in einen UTF-8-Hex-String. Der resultierende String ist komplett kleingeschrieben. Das Ergebnis dieses Funktionsaufrufs ist undefiniert, wenn das Argument kein String-Wert ist.
Zur Unterstützung von Null-Hex-Werten (00) Konvertierung, setze jitterbit.scripting.hex.enable_null_support Zu true davorlegende dieser Funktion, wenn Sie Agent-Versionen ab 11.37 verwenden.
Um den eingehenden String-Wert in einen UTF-16-Hex-String zu konvertieren, setzen Sie jitterbit.scripting.hex.enable_unicode_support Zu true davorlegende dieser Funktion, wenn Agent-Versionen 10.70.1 oder höher oder 11.8.1 oder höher verwendet werden.
Dies ist die Umkehrung der Funktion HexToString.
Beispiele
StringToHex("new");
// Returns "6e6577"
StringToHex("");
// Returns an empty string ("")
StringToHex("§");
// Returns "a7" if jitterbit.scripting.hex.enable_unicode_support is set to true (UTF-16), otherwise returns "c2a7" (UTF-8)
UUIDToBinary
Erklärung
binary UUIDToBinary(string arg)
Syntax
UUIDToBinary(<arg>)
Erforderliche Parameter
arg: Zu konvertierendes String-Element
Beschreibung
Konvertiert eine UUID-Zeichenfolge in einen Binärwert, der die entsprechenden Bytes enthält. Die Größe der Eingabezeichenfolge muss 36 Zeichen betragen. Das Format der Eingabe sollte sein nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn wobei jedes Paar (nn) ist die hexadezimale Darstellung des entsprechenden Bytes. Die Groß-/Kleinschreibung der Eingabezeichenfolge spielt keine Rolle. Der zurückgegebene Binärwert ist 16 Byte lang.
Dies ist die Umkehrung der Funktion BinaryToUID.
Beispiele
UuidToBinary("2f46dad9-e5c2-457e-b1fd-ad1b49b99aff")
// returns a binary value with the bytes
// 0x2F 0x46 0xDA 0xD9 0xE5 0xC2 0x45 0x7E 0xB1 0xFD 0xAD 0x1B 0x49 0xB9 0x9A 0xFF