Funciones de Conversión¶
Las funciones de conversión se utilizan para convertir variables y elementos de datos de Jitterbit de un tipo a otro.
BinaryToHex¶
Declaración¶
string BinaryToHex(binary arg)
Sintaxis¶
BinaryToHex(<arg>)
Parámetros Requeridos¶
arg: Valor binario a convertir
Descripción¶
Convierte un valor binario en una cadena que representa los valores hexadecimales de cada byte. La cadena resultante estará en minúsculas. El resultado de esta llamada de función no está definido si el argumento no es un valor binario.
Esta es la inversa de la función. HexToBinary.
Ejemplos¶
// 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¶
Declaración¶
string BinaryToUUID(binary arg)
Sintaxis¶
BinaryToUUID(<arg>)
Parámetros Requeridos¶
arg: Valor binario a convertir
Descripción¶
Convierte un valor binario de 16 bytes en una cadena en el formato UUID estándar. La cadena resultante siempre estará en minúsculas.
Esta es la inversa de la función. UUIDToBinary.
Ejemplos¶
// 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¶
Declaración¶
bool Bool(binary arg)
Sintaxis¶
Bool(<arg>)
Parámetros Requeridos¶
arg: Valor binario a convertir
Descripción¶
Convierte cualquier tipo de datos en un valor booleano (true o false). Si los datos son un número entero o un número de punto flotante distinto de cero, el resultado es true (1). Las cuerdas "true" y "T" devuelve verdadero independientemente del caso ("TRUE", "t", y "True" todos regresan true). En todos los demás casos, el resultado es false (0).
Ejemplos¶
Bool(2);
// Returns true
Bool("true");
// Returns true
Bool("F");
// Returns false
Bool("text");
// Returns false
Date¶
Declaración¶
date Date(type arg)
Sintaxis¶
Date(<arg>)
Parámetros Requeridos¶
arg: Valor que se convertirá en un objeto de fecha
Descripción¶
Convierte el argumento en una fecha. Si la entrada es una cadena, debe formatearse utilizando uno de los formatos de fecha estándar, como "12/25/2018 12:30","2018-12-25", "2018-12-25T12:30:00","December 25, 2018", o"DEC 25, 2018".
Si la cadena de entrada no está en uno de los cuatro formatos de fecha predefinidos (GeneralDate, LongDate, MediumDate, o ShortDate) que puede ser leído por el Date función, se puede convertir primero a un formato estándar mediante el CVTDate función. Hora, minuto y segundo son opcionales.
Si la entrada es un número entero o un doble, la entrada se interpreta como el número de segundos desde las 12:00:00 a. m. del 1/1/1970 UTC, el comienzo de la época de UNIX.
Tenga en cuenta que Date(Long(Now())) == Now().
Ejemplos¶
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¶
Declaración¶
double Double(type arg)
Sintaxis¶
Double(<arg>)
Parámetros Requeridos¶
arg: Valor a convertir
Descripción¶
Se hace un mejor esfuerzo para convertir el argumento en un doble. Si el tipo de datos que se evalúa no se puede convertir a doble, la función devuelve 0. Si los datos que se evalúan son un registro de fecha u hora, el resultado es la cantidad de segundos desde las 12:00:00 a. m. del 1/1/1970 UTC (el comienzo de la época de UNIX).
Ejemplos¶
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¶
Declaración¶
float Float(type arg)
Sintaxis¶
Float(<arg>)
Parámetros Requeridos¶
arg: Valor a convertir
Descripción¶
Se hace un mejor esfuerzo para convertir el argumento en un flotante. Si el tipo de datos que se evalúa no se puede convertir en flotante, la función devuelve 0. Si los datos que se evalúan son un registro de fecha u hora, el resultado es la cantidad de segundos desde las 12:00:00 a. m. del 1/1/1970 UTC (el comienzo de la época de UNIX).
Ejemplos¶
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¶
Declaración¶
string HexToBinary(string arg)
Sintaxis¶
HexToBinary(<arg>)
Parámetros Requeridos¶
arg: Cadena hexadecimal a convertir
Descripción¶
Convierte una cadena hexadecimal en un valor binario. El valor resultante contendrá los bytes representados por cada par de caracteres en la cadena de entrada. La cadena de entrada no distingue entre mayúsculas y minúsculas.
Esta es la inversa de la función BinaryToHex.
Ejemplos¶
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¶
Declaración¶
string HexToString(string arg)
Sintaxis¶
HexToString(<arg>)
Parámetros Requeridos¶
arg: Elemento de cadena hexadecimal a convertir
Descripción¶
Convierte una cadena hexadecimal en un valor de cadena. El valor resultante contendrá los caracteres representados por cada par de caracteres en la cadena de entrada. La cadena de entrada no distingue entre mayúsculas y minúsculas. Como los caracteres de entrada son hexadecimales, los pares de caracteres de la cadena de entrada deben limitarse al rango de "00" a "FF".
Para usar UTF-8 para el valor de cadena saliente, configure jitterbit.scripting.hex.enable_unicode_support a true arriba en la cadena de esta función cuando se usan las versiones de agente 10.70.1 o posterior o 11.8.1 o posterior.
Esta es la inversa de la función. StringToHex.
Ejemplos¶
HexToString("6E6577");
// Returns the string "new"
HexToString("00");
// Returns an empty string ""
Int¶
Declaración¶
int Int(type arg)
Sintaxis¶
Int(<arg>)
Parámetros Requeridos¶
arg: Valor a convertir
Descripción¶
Se hace un mejor esfuerzo para convertir el argumento en un número entero. Si el tipo de datos que se evalúa no se puede convertir a un número entero, la función devuelve 0. Si los datos que se evalúan son un registro de fecha u hora, el resultado es la cantidad de segundos desde las 12:00:00 a. m. del 1/1/1970 UTC (el comienzo de la época de UNIX).
Ejemplos¶
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¶
Declaración¶
long Long(type arg)
Sintaxis¶
Long(<arg>)
Parámetros Requeridos¶
arg: Valor a convertir
Descripción¶
Se hace un mejor esfuerzo para convertir el argumento en un entero largo. Si el tipo de datos que se evalúa no se puede convertir a un entero largo, la función devuelve 0. Si los datos que se evalúan son un registro de fecha u hora, el resultado es el número de segundos desde las 12:00:00 a. m. del 1/1/ 1970 UTC (el comienzo de la época de UNIX).
Ejemplos¶
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¶
Declaración¶
string String(type arg)
Sintaxis¶
String(<arg>)
Parámetros Requeridos¶
arg: Valor a convertir
Descripción¶
Convierte cualquier tipo de datos en una cadena. Si los datos que se evalúan ya son una cadena, no se realiza ninguna conversión.
Si el tipo de datos es un registro de fecha u hora, la fecha se devuelve en formato ISO 8601 (aaaa-mm-dd HH:MM:SS). Para otros formatos de fecha, utilice las funciones CVTDate o FormatDate.
Los datos binarios que contienen bytes nulos se devuelven como una cadena que representa los valores hexadecimales de cada byte, como si BinaryToHex había sido llamado. Si los datos binarios no contienen bytes nulos, se devuelve una representación de cadena suponiendo que los bytes representan una cadena codificada en UTF-8. Si siempre desea una representación hexadecimal, utilice el BinaryToHex función en su lugar.
Para un valor booleano, se devuelven las cadenas "1" o "0".
Ejemplos¶
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¶
Declaración¶
string StringToHex(string arg)
Sintaxis¶
StringToHex(<arg>)
Parámetros Requeridos¶
arg: Elemento de cadena a convertir
Descripción¶
Convierte un valor de cadena en una cadena que representa los valores hexadecimales de cada byte. La cadena resultante estará en minúsculas. El resultado de esta llamada de función no está definido si el argumento no es un valor de cadena.
Para usar UTF-8 para el valor de cadena entrante, configure jitterbit.scripting.hex.enable_unicode_support a true arriba en la cadena de esta función cuando se usan las versiones de agente 10.70.1 o posterior o 11.8.1 o posterior.
Esta es la inversa de la función. HexToString.
Ejemplos¶
// 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¶
Declaración¶
binary UUIDToBinary(string arg)
Sintaxis¶
UUIDToBinary(<arg>)
Parámetros Requeridos¶
arg: Elemento de cadena a convertir
Descripción¶
Convierte una cadena UUID en un valor binario que contiene los bytes correspondientes. El tamaño de la cadena de entrada debe ser de 36 caracteres. El formato de la entrada debe ser nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn donde cada par (nn) es la representación hexadecimal del byte correspondiente. El caso de la cadena de entrada no importa. El valor binario devuelto tiene una longitud de 16 bytes.
Esta es la inversa de la función. BinaryToUID.
Ejemplos¶
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