Funciones de Conversión¶
Las funciones de conversión se utilizan para convertir variables y elementos de datos 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á toda en minúsculas. El resultado de esta llamada a 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 a 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 a convertir a 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 botón CVTDate
función. La hora, los minutos y los segundos son opcionales.
Si la entrada es un número entero o doble, la entrada se interpreta como el número de segundos desde las 12:00:00 a. m. del 1/1/1970 UTC, el inicio de la época 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 todo lo posible 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 el número de segundos desde las 12:00:00 a. m. del 1/1/1970 UTC (el inicio de la era 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 todo lo posible para convertir el argumento en flotante. Si el tipo de datos que se evalúa no se puede convertir a flotante, 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 era 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 UTF-8 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 "00" a "FF".
Para convertir el valor de cadena saliente de una cadena hexadecimal UTF-16, establezca jitterbit.scripting.hex.enable_unicode_support
a true
arriba en la cadena de esta función cuando se utilizan las versiones del agente 10.71/11.9 o posteriores.
Esta es la inversa de la función. StringToHex
.
Ejemplos¶
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
¶
Declaración¶
int Int(type arg)
Sintaxis¶
Int(<arg>)
Parámetros Requeridos¶
arg
: Valor a convertir
Descripción¶
Se hace un gran esfuerzo para convertir el argumento a 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 el número de segundos desde las 12:00:00 a. m. del 1/1/1970 UTC (el inicio de la era 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 gran esfuerzo para convertir el argumento a un número 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 inicio de la era 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 asumiendo que los bytes representan una cadena codificada en UTF-8. Si siempre desea una representación hexadecimal, utilice el BinaryToHex
funcionar 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 hexadecimal UTF-8. La cadena resultante estará toda en minúsculas. El resultado de esta llamada a función no está definido si el argumento no es un valor de cadena.
Para convertir el valor de la cadena entrante a una cadena hexadecimal UTF-16, establezca jitterbit.scripting.hex.enable_unicode_support
a true
arriba en la cadena de esta función cuando se utilizan las versiones del agente 10.71/11.9 o posteriores.
Esta es la inversa de la función. HexToString
.
Ejemplos¶
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
¶
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