Saltar al contenido

Funciones de conversión

Las funciones de conversión se utilizan para convertir elementos de datos y variables de Jitterbit de un tipo a otro.

BinaryToHex

Declaración

string BinaryToHex(binary arg)

Sintaxis

BinaryToHex(<arg>)

Parámetros necesarios

  • 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 función inversa 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 necesarios

  • 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 función inversa 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 necesarios

  • arg: Valor binario a convertir

Descripción

Convierte cualquier tipo de datos en un valor booleano (true o false). Si el dato es 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 necesarios

  • 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 con 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 CVTDate La hora, los minutos y los segundos son opcionales.

Si la entrada es un entero o un doble, la entrada se interpreta como la cantidad de segundos a partir de las 12:00:00 a. m. del 1/1/1970 UTC, el inicio 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 necesarios

  • 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 está evaluando no se puede convertir en un doble, la función devuelve 0. Si los datos que se están evaluando son un registro de fecha u hora, el resultado es la cantidad de segundos a partir de 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 necesarios

  • arg: Valor a convertir

Descripción

Se hace todo lo posible para convertir el argumento en un valor de punto flotante. Si el tipo de datos que se está evaluando no se puede convertir en un valor de punto flotante, la función devuelve 0. Si los datos que se están evaluando son un registro de fecha u hora, el resultado es la cantidad de segundos a partir de 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.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

Declaración

string HexToBinary(string arg)

Sintaxis

HexToBinary(<arg>)

Parámetros necesarios

  • arg: Cadena hexadecimal que se va 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 función inversa de 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 necesarios

  • arg: Elemento de cadena hexadecimal que se va 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 de "00" a "FF".

Para convertir el valor de cadena saliente de una cadena hexadecimal UTF-16, configure jitterbit.scripting.hex.enable_unicode_support a true arriba en la cadena de esta función cuando se utilizan versiones de agente 10.71 / 11.9 o posteriores.

Esta es la función inversa 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 necesarios

  • arg: Valor a convertir

Descripción

Se hace todo lo posible para convertir el argumento en un entero. Si el tipo de datos que se evalúa no se puede convertir en un 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 a partir de 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 necesarios

  • arg: Valor a convertir

Descripción

Se hace todo lo posible para convertir el argumento en un entero largo. Si el tipo de datos que se evalúa no se puede convertir en 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 la cantidad de segundos a partir de 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 necesarios

  • arg: Valor a convertir

Descripción

Convierte cualquier tipo de datos en una cadena. Si los datos que se están evaluando 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 si los datos binarios no contienen bytes nulos, se devuelve una representación de cadena con la suposición de 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 necesarios

  • arg: Elemento de cadena que se va a convertir

Descripción

Convierte un valor de cadena en una cadena hexadecimal UTF-8. 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 convertir el valor de cadena entrante en una cadena hexadecimal UTF-16, configure jitterbit.scripting.hex.enable_unicode_support a true arriba en la cadena de esta función cuando se utilizan versiones de agente 10.71 / 11.9 o posteriores.

Esta es la función inversa 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 necesarios

  • arg: Elemento de cadena que se va 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. No importa si la cadena de entrada es mayúscula o minúscula. El valor binario devuelto tiene una longitud de 16 bytes.

Esta es la función inversa 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