Funções de Conversão¶
As funções de conversão são usadas para converter variáveis e elementos de dados Jitterbit de um tipo para outro.
BinaryToHex¶
Declaração¶
string BinaryToHex(binary arg)
Sintaxe¶
BinaryToHex(<arg>)
Parâmetros Necessá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 será toda em letras 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 Necessá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 será minúscula.
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 Necessá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 Necessá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 um duplo, a entrada será interpretada como o número de segundos a partir das 12:00:00 AM de 1/1/1970 UTC, o início da época do 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 Necessários¶
arg: Valor a ser convertido
Descrição¶
Um esforço máximo é feito para converter o argumento em um duplo. Se o tipo de dado que está sendo avaliado não puder ser convertido em 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 de 12:00:00 AM de 01/01/1970 UTC (o início da época do 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 Necessários¶
arg: Valor a ser convertido
Descrição¶
Um esforço máximo é feito para converter o argumento em float. Se o tipo de dado que está sendo avaliado não pode ser convertido em float, a função retorna 0. Se o dado que está sendo avaliado é um registro de data ou hora, o resultado é o número de segundos de 12:00:00 AM de 1/1/1970 UTC (o início da época do 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 Necessá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 Necessários¶
arg: Elemento de string hexadecimal a ser convertido
Descrição¶
Converte uma string hexadecimal 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 usar UTF-8 para o valor de string de saída, defina jitterbit.scripting.hex.enable_unicode_support para true acima na cadeia desta função ao usar as versões de agente 10.70.1 ou posterior ou 11.8.1 ou posterior.
Este é o inverso da função StringToHex.
Exemplos¶
HexToString("6E6577");
// Returns the string "new"
HexToString("00");
// Returns an empty string ""
Int¶
Declaração¶
int Int(type arg)
Sintaxe¶
Int(<arg>)
Parâmetros Necessários¶
arg: Valor a ser convertido
Descrição¶
Um melhor esforço é feito para converter o argumento em um número inteiro. Se o tipo de dado que está sendo avaliado não pode ser convertido em um número inteiro, a função retorna 0. Se o dado que está sendo avaliado é um registro de data ou hora, o resultado é o número de segundos de 12:00:00 AM de 01/01/1970 UTC (o início da época do 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 Necessá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 dados sendo avaliado não puder ser convertido em um inteiro longo, a função retornará 0. Se os dados sendo avaliados forem um registro de data ou hora, o resultado será o número de segundos de 12:00:00 AM de 1/1/ 1970 UTC (o início da época do 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 Necessá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 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 Necessários¶
arg: Elemento de string a ser convertido
Descrição¶
Converte um valor de string em uma string que representa os valores hexadecimais de cada byte. A string resultante será toda em letras minúsculas. O resultado desta chamada de função é indefinido se o argumento não for um valor de string.
Para usar UTF-8 para o valor de string de entrada, defina jitterbit.scripting.hex.enable_unicode_support para true acima na cadeia desta função ao usar as versões de agente 10.70.1 ou posterior ou 11.8.1 ou posterior.
Este é o inverso da função HexToString.
Exemplos¶
// If $x is a string value containing the bytes "new"
StringToHex($x)
// returns the string "6e6577"
// If $y is an empty string value
StringToHex($y)
// returns an empty string ("")
UUIDToBinary¶
Declaração¶
binary UUIDToBinary(string arg)
Sintaxe¶
UUIDToBinary(<arg>)
Parâmetros Necessá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 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