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 que representa os valores hexadecimais de cada byte. A string resultante estará toda em letras minúsculas. O resultado desta chamada de função será 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 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 dados 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 em um objeto de data
Descrição¶
Converte o argumento em uma data. Se a entrada for uma string, ela deverá 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, ele pode ser convertido primeiro para um formato padrão pelo CVTDate
função. Hora, minuto e segundo são opcionais.
Se a entrada for um número inteiro ou duplo, a entrada será interpretada como o número de segundos a partir das 12h00 de 01/01/1970 UTC, o início da época 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¶
É feito o melhor esforço para converter o argumento em um duplo. Se o tipo de dados que está sendo avaliado não puder ser convertido em duplo, 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 00:00:00 de 01/01/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¶
É feito o melhor esforço para converter o argumento em float. Se o tipo de dados que está sendo avaliado não puder ser convertido em flutuante, 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 12h00 de 01/01/1970 UTC (o início da época UNIX).
Exemplos¶
Float(345);
// Returns a value of 345
Float("3.141592");
// Returns a value of 3.141592
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
: String hexadecimal 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 de string 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 o agente versões 10.71/11.9 ou posterior.
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¶
É feito o melhor esforço para converter o argumento em um número inteiro. Se o tipo de dados que está sendo avaliado não puder ser convertido em um número inteiro, 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 00:00:00 de 01/01/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¶
É feito o melhor esforço para converter o argumento em um número inteiro longo. Se o tipo de dados que está sendo avaliado não puder ser convertido em um número inteiro longo, 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 00:00:00 de 1/1/ 1970 UTC (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 dados em uma string. Se os dados que estão sendo avaliados já forem uma string, nenhuma conversão ocorrerá.
Se o tipo de dados 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
.
Os dados binários que contêm bytes nulos são retornados como uma string representando os valores hexadecimais de cada byte, como se BinaryToHex
havia sido 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
funcionar 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 estará toda em letras minúsculas. O resultado desta chamada de função será indefinido se o argumento não for um valor de string.
Para converter o valor da 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.70.1 ou posterior ou 11.8.1 ou posterior.
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 de 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.
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