Konvertierungsfunktionen im Jitterbit Design 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: Binärwert, der konvertiert werden soll

Beschreibung

Konvertiert einen Binärwert 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ärwert 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: Binärwert, der konvertiert werden soll

Beschreibung

Konvertiert einen 16-Byte-Binärwert 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: Binärwert, der konvertiert werden soll

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

Datum

Deklaration

date Date(type arg)

Syntax

Date(<arg>)

Erforderliche Parameter

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

Beschreibung

Wandelt das Argument in ein Datum um. Wenn die Eingabe ein String 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 der Eingabestring nicht in einem der vier vordefinierten Datumsformate (GeneralDate, LongDate, MediumDate oder ShortDate), die von der Date-Funktion gelesen werden können, vorliegt, kann er zuerst mit der CVTDate Funktion in ein Standardformat umgewandelt werden. Stunde, Minute und Sekunde sind optional.

Wenn die Eingabe eine Ganzzahl oder eine Gleitkommazahl ist, wird die Eingabe als die 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().

Mit Agenten der Version 12.8 und höher, wenn die Eingabe Mitternacht (00:00:00) darstellt, behält das resultierende Datumsobjekt die Zeitkomponente bei, anstatt als nur Datum behandelt zu werden.

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)

Date("2025-04-17 00:00:00");
// Returns the date that represents 2025-04-17 00:00:00

Double

Deklaration

double Double(type arg)

Syntax

Double(<arg>)

Erforderliche Parameter

• arg: Wert, der umgewandelt werden soll

Beschreibung

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

Deklaration

string HexToString(string arg)

Syntax

HexToString(<arg>)

Erforderliche Parameter

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

Beschreibung

Konvertiert eine UTF-8-Hex-Zeichenfolge in einen Zeichenwert. Der resultierende Wert enthält die Zeichen, die durch jedes Paar von Zeichen in der Eingabezeichenfolge dargestellt werden. Die Eingabezeichenfolge ist nicht groß-/kleinschreibungsempfindlich. Da die Eingabezeichen hexadezimal ist, müssen die Zeichenpaare der Eingabezeichenfolge 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 Zeichenwert von einer UTF-16-Hex-Zeichenfolge 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.

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

Deklaration

int Int(type arg)

Syntax

Int(<arg>)

Erforderliche Parameter

• arg: Wert, der konvertiert werden soll

Beschreibung

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 AM 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

Declaration

long Long(type arg)

### Syntax {: #syntax }

#### Required parameters {: #required-parameters }

-   **`arg`:** Wert, der konvertiert werden soll

### Description {: #description }

Es wird versucht, das Argument in eine Long-Integer zu konvertieren. Wenn der zu bewertende Datentyp nicht in eine Long-Integer 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 (der Beginn der UNIX-Epoche).

### Examples {: #examples }

<div markdown="1" class="conf-macro output-inline" align="center" hasbody="false" macro-name="backtotop">

[[Back to top]](#top)

</div>


## `String`{: #conversionfunctions-string }

### Declaration {: #declaration }

### Syntax {: #syntax }

#### Required parameters {: #required-parameters }

-   **`arg`:** Wert, der konvertiert werden soll

### Description {: #description }

Konvertiert jeden Datentyp in einen String. Wenn die zu bewertenden Daten bereits ein String sind, findet keine Konvertierung statt.

Wenn der Datentyp ein Datum oder ein Zeitstempel ist, 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 String zurückgegeben, der die hexadezimalen Werte jedes Bytes darstellt, als ob `BinaryToHex` aufgerufen worden wäre. Wenn die Binärdaten keine Null-Bytes enthalten, wird eine String-Darstellung zurückgegeben, wobei davon ausgegangen wird, dass die Bytes einen UTF-8-codierten String darstellen. Wenn Sie immer eine hexadezimale Darstellung wünschen, verwenden Sie stattdessen die Funktion `BinaryToHex`.

Für einen booleschen Wert werden die Strings "1" oder "0" zurückgegeben.

### Examples {: #examples }

<div markdown="1" class="conf-macro output-inline" align="center" hasbody="false" macro-name="backtotop">

[[Back to top]](#top)

</div>


## `StringToHex`{: #conversionfunctions-stringtohex }

string StringToHex(string arg)

StringToHex(<arg>)

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)

binary UUIDToBinary(string arg)

UUIDToBinary(<arg>)

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