Funções de conversão¶
As funções de conversão são usadas para converter elementos de dados e variáveis Jitterbit de um tipo para outro.
BinaryToHex¶
Declaração¶
string BinaryToHex(binary arg)
Sintaxe¶
BinaryToHex(<arg>)
Parâmetros obrigatórios¶
arg: Valor binário a ser convertido
Descrição¶
Converte um valor binário em uma string representando os valores hexadecimais de cada byte. A string resultante será toda em minúsculas. O resultado desta chamada de função é indefinido se o argumento não for um valor binário.
Este é o inverso da função HexToBinary.
Exemplos¶
// 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¶
Declaração¶
string BinaryToUUID(binary arg)
Sintaxe¶
BinaryToUUID(<arg>)
Parâmetros obrigatórios¶
arg: Valor binário a ser convertido
Descrição¶
Converte um valor binário de 16 bytes em uma string no formato UUID padrão. A string resultante sempre estará em letras minúsculas.
Este é o inverso da função UUIDToBinary.
Exemplos¶
// 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¶
Declaração¶
bool Bool(binary arg)
Sintaxe¶
Bool(<arg>)
Parâmetros obrigatórios¶
arg: Valor binário a ser convertido
Descrição¶
Converte qualquer tipo de dado em um valor booleano (true ou false). Se os dados forem um número inteiro ou um número de ponto flutuante diferente de zero, o resultado será true(1). As cordas "true" e "T" retornar verdadeiro independentemente do caso ("TRUE", "t", e "True" todos retornam true). Em todos os outros casos, o resultado é false(0).
Exemplos¶
Bool(2);
// Returns true
Bool("true");
// Returns true
Bool("F");
// Returns false
Bool("text");
// Returns false
Date¶
Declaração¶
date Date(type arg)
Sintaxe¶
Date(<arg>)
Parâmetros obrigatórios¶
arg: Valor a ser convertido para um objeto de data
Descrição¶
Converte o argumento para uma data. Se a entrada for uma string, ela deve ser formatada usando um dos formatos de data padrão, como "12/25/2018 12:30","2018-12-25", "2018-12-25T12:30:00","December 25, 2018", ou"DEC 25, 2018".
Se a string de entrada não estiver em um dos quatro formatos de data predefinidos (GeneralDate, LongDate, MediumDate, ou ShortDate) que pode ser lido pelo Date função, ela pode ser convertida primeiro para um formato padrão pelo CVTDate. Hora, minuto e segundo são opcionais.
Se a entrada for um inteiro ou um double, a entrada será interpretada como o número de segundos a partir de 12:00:00 AM de 1/1/1970 UTC, o início da era UNIX.
Observe que Date(Long(Now())) == Now().
Exemplos¶
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¶
Declaração¶
double Double(type arg)
Sintaxe¶
Double(<arg>)
Parâmetros obrigatórios¶
arg: Valor a ser convertido
Descrição¶
Um esforço máximo é feito para converter o argumento para um double. Se o tipo de dado que está sendo avaliado não puder ser convertido para um double, a função retornará 0. Se o dado que está sendo avaliado for um registro de data ou hora, o resultado será o número de segundos a partir de 12:00:00 AM de 1/1/1970 UTC (o início da época UNIX).
Exemplos¶
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¶
Declaração¶
float Float(type arg)
Sintaxe¶
Float(<arg>)
Parâmetros obrigatórios¶
arg: Valor a ser convertido
Descrição¶
Um esforço máximo é feito para converter o argumento para um float. Se o tipo de dado que está sendo avaliado não puder ser convertido para um float, a função retornará 0. Se os dados que estão sendo avaliados forem um registro de data ou hora, o resultado será o número de segundos a partir de 12:00:00 AM de 1/1/1970 UTC (o início da época UNIX).
Exemplos¶
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¶
Declaração¶
string HexToBinary(string arg)
Sintaxe¶
HexToBinary(<arg>)
Parâmetros obrigatórios¶
arg: Hex-string a ser convertida
Descrição¶
Converte uma string hexadecimal em um valor binário. O valor resultante conterá os bytes representados por cada par de caracteres na string de entrada. A string de entrada não diferencia maiúsculas de minúsculas.
Este é o inverso da função BinaryToHex.
Exemplos¶
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¶
Declaração¶
string HexToString(string arg)
Sintaxe¶
HexToString(<arg>)
Parâmetros obrigatórios¶
arg: Elemento hexadecimal a ser convertido
Descrição¶
Converte uma string hexadecimal UTF-8 em um valor de string. O valor resultante conterá os caracteres representados por cada par de caracteres na string de entrada. A string de entrada não diferencia maiúsculas de minúsculas. Como os caracteres de entrada são hexadecimais, os pares de caracteres da string de entrada devem ser limitados ao intervalo de "00" a "FF".
Para converter o valor da string de saída de uma string hexadecimal UTF-16, defina jitterbit.scripting.hex.enable_unicode_support para true acima na cadeia desta função ao usar versões de agente 10.71 / 11.9 ou posteriores.
Este é o inverso da função StringToHex.
Exemplos¶
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¶
Declaração¶
int Int(type arg)
Sintaxe¶
Int(<arg>)
Parâmetros obrigatórios¶
arg: Valor a ser convertido
Descrição¶
Um esforço máximo é feito para converter o argumento em um inteiro. Se o tipo de dado que está sendo avaliado não puder ser convertido em um inteiro, a função retornará 0. Se o dado que está sendo avaliado for um registro de data ou hora, o resultado será o número de segundos a partir de 12:00:00 AM de 1/1/1970 UTC (o início da época UNIX).
Exemplos¶
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¶
Declaração¶
long Long(type arg)
Sintaxe¶
Long(<arg>)
Parâmetros obrigatórios¶
arg: Valor a ser convertido
Descrição¶
Um esforço máximo é feito para converter o argumento em um inteiro longo. Se o tipo de dado que está sendo avaliado não puder ser convertido em um inteiro longo, a função retornará 0. Se o dado que está sendo avaliado for um registro de data ou hora, o resultado será o número de segundos a partir de 12:00:00 AM de 1/1/1970 UTC (o início da época UNIX).
Exemplos¶
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¶
Declaração¶
string String(type arg)
Sintaxe¶
String(<arg>)
Parâmetros obrigatórios¶
arg: Valor a ser convertido
Descrição¶
Converte qualquer tipo de dado em uma string. Se os dados que estão sendo avaliados já forem uma string, nenhuma conversão ocorrerá.
Se o tipo de dado for um registro de data ou hora, a data será retornada no formato ISO 8601 (aaaa-mm-dd HH:MM:SS). Para outros formatos de data, use as funções CVTDate ou FormatDate.
Dados binários que contêm bytes nulos são retornados como uma string representando os valores hexadecimais de cada byte, assim como se BinaryToHex foi chamado. Se os dados binários não contiverem bytes nulos, uma representação de string será retornada com a suposição de que os bytes representam uma string codificada em UTF-8. Se você sempre quiser uma representação hexadecimal, use o BinaryToHex função em vez disso.
Para um valor booleano, as strings "1" ou "0" são retornadas.
Exemplos¶
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¶
Declaração¶
string StringToHex(string arg)
Sintaxe¶
StringToHex(<arg>)
Parâmetros obrigatórios¶
arg: Elemento de string a ser convertido
Descrição¶
Converte um valor de string em uma string hexadecimal UTF-8. A string resultante será toda em minúsculas. O resultado desta chamada de função é indefinido se o argumento não for um valor de string.
Para converter o valor de string de entrada em uma string hexadecimal UTF-16, defina jitterbit.scripting.hex.enable_unicode_support para true acima na cadeia desta função ao usar versões de agente 10.71 / 11.9 ou posteriores.
Este é o inverso da função HexToString.
Exemplos¶
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¶
Declaração¶
binary UUIDToBinary(string arg)
Sintaxe¶
UUIDToBinary(<arg>)
Parâmetros obrigatórios¶
arg: Elemento de string a ser convertido
Descrição¶
Converte uma string UUID em um valor binário contendo os bytes correspondentes. O tamanho da string de entrada deve ser 36 caracteres. O formato da entrada deve ser nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn onde cada par (nn) é a representação hexadecimal do byte correspondente. O caso da string de entrada não importa. O valor binário retornado tem 16 bytes de comprimento.
Este é o inverso da função BinaryToUID.
Exemplos¶
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