Konvertierungsfunktionen in Jitterbit Studio

Konvertierungsfunktionen werden verwendet, um Jitterbit-Daten-Elemente und Variablen von einem Typ in einen anderen zu konvertieren.

BinaryToHex

Deklaration

string BinaryToHex(binary arg)

Syntax

BinaryToHex(<arg>)

Erforderliche Parameter

• arg: Zu konvertierender binärer Wert

Beschreibung

Konvertiert einen binären Wert in eine Zeichenkette, die die hexadezimalen Werte jedes Bytes darstellt. Die resultierende Zeichenkette wird vollständig in Kleinbuchstaben sein. Das Ergebnis dieses Funktionsaufrufs ist undefiniert, wenn das Argument kein binärer Wert ist.

Dies ist das Gegenteil 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

Deklaration

string BinaryToUUID(binary arg)

Syntax

BinaryToUUID(<arg>)

Erforderliche Parameter

• arg: Zu konvertierender binärer Wert

Beschreibung

Konvertiert einen 16-Byte-binären Wert in eine Zeichenkette im standardmäßigen UUID-Format. Die resultierende Zeichenkette wird immer in Kleinbuchstaben sein.

Dies ist das Gegenteil 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

Deklaration

bool Bool(binary arg)

Syntax

Bool(<arg>)

Erforderliche Parameter

• arg: Zu konvertierender binärer Wert

Beschreibung

Konvertiert jeden Datentyp in einen booleschen Wert (true oder false). Wenn die Daten eine Ganzzahl oder eine Fließkommazahl ungleich null sind, ist das Ergebnis true (1). Die Zeichenfolgen "true" und "T" geben unabhängig von der Groß- und Kleinschreibung true zurück ("TRUE", "t" und "True" geben alle true zurück). 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

Deklaration

date Date(type arg)

Syntax

Date(<arg>)

Erforderliche Parameter

• arg: Wert, der in ein Datumsobjekt konvertiert werden soll

Beschreibung

Konvertiert das Argument in ein Datum. Wenn die Eingabe eine Zeichenfolge ist, muss sie in einem der Standarddatumsformate wie "12/25/2018 12:30", "2018-12-25", "2018-12-25T12:30:00", "25. Dezember 2018" oder "25. DEZ 2018" formatiert sein.

Wenn die Eingabezeichenfolge nicht in einem der vier vordefinierten Datumsformate (GeneralDate, LongDate, MediumDate oder ShortDate), die von der Date-Funktion gelesen werden können, vorliegt, kann sie zuerst mit der CVTDate Funktion in ein Standardformat konvertiert werden. Stunde, Minute und Sekunde sind optional.

Wenn die Eingabe eine Ganzzahl oder eine Fließkommazahl ist, wird die Eingabe als Anzahl der Sekunden seit 12:00:00 AM am 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

Deklaration

double Double(type arg)

Syntax

Double(<arg>)

Erforderliche Parameter

• arg: Wert, der konvertiert werden soll

Beschreibung

Es wird versucht, das Argument in eine Double-Zahl zu konvertieren. Wenn der zu bewertende Datentyp nicht in ein Double konvertiert werden kann, gibt die Funktion 0 zurück. Wenn die zu bewertenden Daten ein Datum oder eine Zeitangabe sind, ist das Ergebnis die Anzahl der Sekunden seit 12:00:00 AM am 1.1.1970 UTC (der 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

Deklaration

float Float(type arg)

Syntax

Float(<arg>)

Erforderliche Parameter

• arg: Wert, der konvertiert werden soll

Beschreibung

Es wird versucht, das Argument in eine Float-Zahl zu konvertieren. Wenn der zu bewertende Datentyp nicht in ein Float konvertiert werden kann, gibt die Funktion 0 zurück. Wenn die zu bewertenden Daten ein Datum oder eine Zeitangabe sind, ist das Ergebnis die Anzahl der Sekunden seit 12:00:00 AM am 1.1.1970 UTC (der 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

Deklaration

string HexToBinary(string arg)

Syntax

HexToBinary(<arg>)

Erforderliche Parameter

• arg: Hex-String, der konvertiert werden soll

Beschreibung

Konvertiert einen Hex-String in einen binären Wert. Der resultierende Wert enthält die Bytes, die durch jedes Paar von Zeichen im Eingabestring dargestellt werden. Der Eingabestring ist nicht groß-/kleinschreibungsempfindlich.

Dies ist das Gegenteil 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

Declaration

string HexToString(string arg)

Syntax

HexToString(<arg>)

Required parameters

• arg: Hex-String-Element, das konvertiert werden soll

Description

Konvertiert einen UTF-8-Hex-String in einen String-Wert. Der resultierende Wert enthält die Zeichen, die durch jedes Zeichenpaar im Eingabestring dargestellt werden. Der Eingabestring ist nicht groß-/kleinschreibungsempfindlich. Da die Eingabezeichen hexadezimal sind, müssen die Zeichenpaare des Eingabestrings auf den Bereich "00" bis "FF" beschränkt sein.

Um die Konvertierung eines null-Hexwerts (00) zu unterstützen, setzen Sie jitterbit.scripting.hex.enable_null_support auf true, bevor Sie diese Funktion verwenden, wenn Sie Agent-Versionen 11.37 oder höher verwenden.

Um den ausgehenden String-Wert von einem UTF-16-Hex-String zu konvertieren, setzen Sie jitterbit.scripting.hex.enable_unicode_support auf true, bevor Sie diese Funktion verwenden, wenn Sie Agent-Versionen 10.71 / 11.9 oder höher verwenden.

Dies ist das Gegenteil der Funktion StringToHex.

Examples

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

Declaration

int Int(type arg)

Syntax

Int(<arg>)

Required parameters

• arg: Wert, der konvertiert werden soll

Description

Es wird versucht, das Argument in eine Ganzzahl zu konvertieren. Wenn der zu bewertende Datentyp nicht in eine Ganzzahl konvertiert werden kann, gibt die Funktion 0 zurück. Wenn die zu bewertenden Daten ein Datum oder einen Zeitstempel darstellen, ist das Ergebnis die Anzahl der Sekunden seit 12:00:00 Uhr am 1.1.1970 UTC (der 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

Deklaration

long Long(type arg)

Syntax

Long(<arg>)

Erforderliche Parameter

• arg: Wert, der konvertiert werden soll

Beschreibung

Es wird versucht, das Argument in eine lange Ganzzahl zu konvertieren. Wenn der zu bewertende Datentyp nicht in eine lange Ganzzahl konvertiert werden kann, gibt die Funktion 0 zurück. Wenn die zu bewertenden Daten ein Datum oder einen Zeitstempel darstellen, ist das Ergebnis die Anzahl der Sekunden seit 12:00:00 AM am 1.1.1970 UTC (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

Deklaration

string String(type arg)

Syntax

String(<arg>)

Erforderliche Parameter

• arg: Wert, der konvertiert werden soll

Beschreibung

Konvertiert jeden Datentyp in eine Zeichenkette. Wenn der zu bewertende Datentyp bereits eine Zeichenkette ist, findet keine Konvertierung statt.

Wenn der Datentyp ein Datum oder einen Zeitstempel darstellt, wird das Datum im ISO 8601-Format (yyyy-mm-dd HH:MM:SS) zurückgegeben. Für andere Datumsformate verwenden Sie die Funktionen CVTDate oder FormatDate.

Binärdaten, die Null-Bytes enthalten, werden als Zeichenkette zurückgegeben, die die hexadezimalen Werte jedes Bytes darstellt, als ob BinaryToHex aufgerufen worden wäre. Wenn die Binärdaten keine Null-Bytes enthalten, wird eine Zeichenkettenrepräsentation zurückgegeben, wobei davon ausgegangen wird, dass die Bytes eine UTF-8-codierte Zeichenkette darstellen. Wenn Sie immer eine hexadezimale Darstellung wünschen, verwenden Sie stattdessen die Funktion BinaryToHex.

Für einen booleschen Wert werden die Zeichenketten "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

Deklaration

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 wird vollständig in Kleinbuchstaben sein. Das Ergebnis dieses Funktionsaufrufs ist undefiniert, wenn das Argument kein String-Wert ist.

Um die Konvertierung eines null-Hex-Werts (00) zu unterstützen, setzen Sie jitterbit.scripting.hex.enable_null_support auf true, bevor Sie diese Funktion verwenden, wenn Sie Agent-Versionen 11.37 oder höher verwenden.

Um den eingehenden String-Wert in einen UTF-16-Hex-String zu konvertieren, setzen Sie jitterbit.scripting.hex.enable_unicode_support auf true, bevor Sie diese Funktion verwenden, wenn Sie Agent-Versionen 10.71 / 11.9 oder höher verwenden.

Dies ist das Gegenteil 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

Deklaration

binary UUIDToBinary(string arg)

Syntax

UUIDToBinary(<arg>)

Erforderliche Parameter

• arg: Zu konvertierendes String-Element

Beschreibung

Konvertiert einen UUID-String in einen binären Wert, der die entsprechenden Bytes enthält. Die Größe des Eingabestrings muss 36 Zeichen betragen. Das Format der Eingabe sollte nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn sein, wobei jedes Paar (nn) die hexadezimale Darstellung des entsprechenden Bytes ist. Die Groß- und Kleinschreibung des Eingabestrings spielt keine Rolle. Der zurückgegebene binäre Wert ist 16 Bytes lang.

Dies ist die Umkehrung der Funktion BinaryToUID.

Beispiele

UuidToBinary("2f46dad9-e5c2-457e-b1fd-ad1b49b99aff")
// gibt einen binären Wert mit den Bytes zurück
// 0x2F 0x46 0xDA 0xD9 0xE5 0xC2 0x45 0x7E 0xB1 0xFD 0xAD 0x1B 0x49 0xB9 0x9A 0xFF