Funciones utilizadas en IBM

InfoSphere
DataStage and QualityStage
Última actualización: 2021-02-28

Las funciones que son válidas en el Diseñador de InfoSphere DataStage and QualityStage, también lo son
en IBM® InfoSphere FastTrack. La lista de funciones de esta sección se utiliza generalmente al definir una
derivación de columna en una etapa Transformer.

 Funciones de fecha y hora

 Funciones lógicas
 Funciones matemáticas
 Funciones de manejo nulo
 Funciones de número
 Funciones Sin formato
 Funciones de serie
 Función Vector
 Funciones de tipo de conversión
 Funciones de tipo casting
 Funciones de programa de utilidad

Funciones de fecha y hora

Última actualización: 2021-02-28

La siguiente tabla muestra una lista de las funciones disponibles en la categoría Fecha y hora (los corchetes
indican que un argumento es opcional):

Nombre Descripción Argumentos Salida

Devuelve una fecha añadiendo

número (int32) [fecha de línea
DateFromDaysSince un entero a la fecha de línea fecha
base]
base

Devuelve una fecha de la fecha

DateFromJulianDay fecha juliana (uint32) fecha
juliana proporcionada

Devuelve el número de días de fecha_proporcionada

DaysSinceFromDate la fecha de origen a la fecha fecha desde (int32)
proporcionada fecha_origen

Devuelve la parte de horas de

HoursFromTime hora horas (int8)
una hora

Devuelve el día juliano de la

JulianDayFromDate fecha fecha juliana (int32)
fecha proporcionada

Devuelve la parte de
MicroSecondsFromTime hora microsegundos (int32)
microsegundo de una hora
Nombre Descripción Argumentos Salida

Devuelve la parte de minutos

MinutesFromTime hora minutos (int8)
de una hora

Devuelve el día del mes de la

MonthDayFromDate fecha día (int8)
fecha proporcionada

Devuelve el número del mes de

MonthFromDate fecha número de mes (int8)
la fecha proporcionada

Devuelve la fecha del día fecha de origen

NextWeekdayFromDate especificado de la semana fecha
siguiente a la fecha de origen día de la semana (serie)
Devuelve la fecha del día
especificado de la semana más fecha de origen
PreviousWeekdayFromDate fecha
reciente respecto al día de
origen día de la semana (serie)

Devuelve la parte de segundos

SecondsFromTime hora segundos (dfloat)
de una hora

Devuelve el número de
indicación de fecha y hora base
SecondsSinceFromTimestamp segundos entre dos segundos (dfloat)
indicación de fecha y hora
indicaciones de hora y fecha

Devuelve la hora del sistema y

fecha y hora del
TimeDate la fecha como una serie de -
sistema (string)
formato

Devuelve la hora respecto al

TimeFromMidnightSeconds número de segundos desde la segundos (dfloat) hora
medianoche

Devuelve el formulario de
indicación de fecha y hora indicación de fecha y
TimestampFromDateTime hora de fecha
respecto a la hora y la fecha hora
proporcionados

Devuelve la indicación de segundos (dfloat)

fecha y hora del número de indicación de fecha y
TimestampFromSecondsSince
segundos de la indicación de [indicación de fecha y hora hora
fecha y hora base base]
Devuelve la indicación de
indicación de fecha y
TimestampFromTimet fecha y hora respecto al valor timet (int32)
hora
unix time_t proporcionado

Devuelve un valor unix time_t

TimetFromTimestamp de la indicación de fecha y horaindicación de fecha y hora timet (int32)
proporcionada

Devuelve el número de día de

WeekdayFromDate la semana respecto a una fecha fecha [día original] día (int8)
proporcionada. Opcionalmente,
el día original especifica el día
Nombre Descripción Argumentos Salida

que se considera el primer día

de la semana, que de forma
predeterminada es Domingo

Devuelve el número de día del

YeardayFromDate año respecto a una fecha fecha fecha (int16)
proporcionada

Devuelve el año respecto a una

YearFromDate fecha año (int16)
fecha proporcionada

Devuelve el número de semana

YearweekFromDate del año respecto a una fecha fecha semana (int16)
proporcionada

Las funciones Date, Time y Timestamp que especifican fechas, horas e indicaciones de fecha y hora en el
argumento utilizan series con formatos específicos:

Para una fecha el formato es %aaaa-%mm-%dd

Para una hora el formato es %hh:%nn:%ss, o, si se amplía para incluir microsegundos,

%hh:%nn:%ss.x donde x son los segundos decimales.

Para una indicación de fecha y hora el formato es %aaaa-%mm-%dd %hh:%nn:%ss, o, si se amplía para incluir
microsegundos, %aaaa-%mm-%dd %hh:%nn:%ss.x donde x son los segundos decimales.

Esto se aplica a los argumentos fecha, fecha de línea base, fecha proporcionada, hora, indicación de fecha y
hora, e indicación de fecha y hora base.

Las funciones que tiene días de la semana en el argumento pueden utilizar una serie especificando el día de la
semana; esto se aplica al día de una semana y al día original.

 Formatos de fecha y hora

Los trabajos paralelos proporcionan un manejo flexible de los formatos de fecha y hora.

Funciones lógicas
Última actualización: 2021-02-28

La siguiente tabla muestra una lista de funciones disponibles en la categoría Lógica (los corchetes indican que
un argumento es opcional):

Nombre Descripción ArgumentosSalida

Devuelve el
Not complemento expresión Complemento (int8)
del valor
Nombre Descripción ArgumentosSalida
lógico de una
expresión
Devuelve
número 1
AND de bit a
(uint64)
BitAnd bit de dos número (uint64)
número 2
argumentos
(uint64)
enteros
Devuelve OR
número 1
de bit a bit de
(uint64)
BitOr dos número (uint64)
número 2
argumentos
(uint64)
enteros
Devuelve el
OR Exclusivo número 1
de bit a bit de (uint64)
BitXOr número (uint64)
dos número 2
argumentos (uint64)
enteros
Devuelve una
serie que
contiene la
representación número
BitExpand serie
binaria en (uint64)
"1"s y "0"s
del entero
proporcionado
Devuelve el
entero que se
ha creado a
partir del
argumento de número
BitCompress número (uint64)
serie y que (string)
contiene una
representación
binaria de
"1"s y "0"s.
Devuelve un
entero con
bits
específicos origfield
establecidos (uint64)
en un estado bitlist
SetBit específico en (string) número (uint64)
el que
bitstate
origfield es el (uint8)
valor de
entrada sobre
el que se
Nombre Descripción ArgumentosSalida
realiza la
acción,

bitlist es una
serie que
contiene una
lista de
números de
bit separados
por comas
para
establecer el
estado,
y bitstate es 1
o 0 e indica
qué estado se
debe
establecer
para estos
bits.

Funciones matemáticas
Última actualización: 2021-02-28

La siguiente tabla muestra una lista de funciones disponibles en la categoría Matemáticas (los corchetes indican
que un argumento es opcional):

NombreDescripción ArgumentosSalida
Valor absoluto
de cualquier número
Abs resultado (dfloat)
expresión (int32)
numérica
Calcula el
coseno inverso
número
Acos trigonométrico resultado (dfloat)
(dfloat)
de una
expresión
Calcula el seno
inverso
número
Asin trigonométrico resultado (dfloat)
(dfloat)
de una
expresión
Calcula la
tangente
inversa número
Atan resultado (dfloat)
trigonométrica (dfloat)
de una
expresión
NombreDescripción ArgumentosSalida
Calcula el valor
dfloat más
pequeño que es
número
Ceil superior o igual resultado (dfloat)
(decimal)
al valor
decimal
proporcionado
Calcula el
coseno
número
Cos trigonométrico resultado (dfloat)
(dfloat)
de una
expresión
Calcula el
coseno número
Cosh resultado (dfloat)
hiperbólico de (dfloat)
una expresión
Proporciona la
salida de toda
dividendo
la división real
(dfloat)
Div de dos números resultado (dfloat)
divisor
reales
(dfloat)
(dividendo,
divisor)
Calcula el
resultado de la
base 'e' elevada
número
Exp a la potencia resultado (dfloat)
(dfloat)
designada por
el valor de la
expresión
Calcula el valor
absoluto de un número
Fabs resultado (dfloat)
valor (dfloat)
proporcionado
Calcula el valor
dfloat más
grande y menor número
Floor resultado (dfloat)
o igual que el (decimal)
valor decimal
proporcionado
mantisa
Calcula el
(dfloat)
número de un
Ldexp resultado (dfloat)
exponente y
exponente
una mantisa
(int32)
Devuelve el
valor absoluto número
Llabs resultado (int64)
de un entero (uint64)
proporcionado
NombreDescripción ArgumentosSalida
Calcula el
logaritmo
número
Ln natural de una resultado (dfloat)
(dfloat)
expresión en
base 'e'
Devuelve el
registro a la
número
Log10 base 10 del resultado (dfloat)
(dfloat)
valor
proporcionado
Devuelve el
número 1
valor más alto
(int32)
Max de los dos resultado (int32)
número
valores de
2(int32)
argumento
Devuelve el
número 1
valor más bajo
(int32)
Min de los dos resultado (int32)
número 2
valores de
(int32)
argumento
Calcula el
módulo (el
dividendo
remanente) de
(int32)
Mod dos resultado (int32)
divisor
expresiones
(int32)
(dividendo,
divisor)
Invalida un número
Neg resultado (dfloat)
número (dfloat)
Calcula el valor
de una
expresión expresión
cuando se eleva(dfloat)
Pwr resultado (dfloat)
a una potencia potencia
especificada (dfloat)
(expresión,
potencia)
Devuelve un
entero
Rand - resultado (uint32)
pseudoaleatorio
entre 0 y 232-1
Devuelve un
número
Random - resultado (uint32)
aleatorio entre
0 y 232-1
Calcula el seno
número
Sin trigonométrico resultado (dfloat)
(dfloat)
de un ángulo
NombreDescripción ArgumentosSalida
Calcula el seno
número
Sinh hiperbólico de resultado (dfloat)
(dfloat)
una expresión
Calcula la raíz
número
Sqrt cuadrada de un resultado (dfloat)
(dfloat)
número
Calcula la
tangente número
Tan resultado (dfloat)
trigonométrica (dfloat)
de un ángulo
Calcula la
tangente número
Tanh resultado (dfloat)
hiperbólica de (dfloat)
una expresión

Funciones de manejo nulo

Última actualización: 2021-02-28

La siguiente tabla muestra una lista de funciones disponibles en la categoría Manejo nulo (los corchetes indican
que un argumento es opcional):

Nombre Descripción Argumentos Salida

Devuelve True
cuando una
IsNotNull expresión no se cualquiera true/false (int8)
evalúa con el valor
nulo
Devuelve True
cuando una
IsNull cualquiera true/false (int8)
expresión se evalúa
con el valor nulo
Devuelve una serie
vacía si la columna
de entrada es nula, columna de
NullToEmpty valor de columna de entrada o serie vacía
de lo contrario entrada
devuelve el valor de
columna de entrada
Devuelve un cero si
la columna de
entrada es nula, de
columna de
NullToZero lo contrario valor de columna de entrada o cero
entrada
devuelve al valor de
la columna de
entrada
Devuelve columna de
NullToValue valor de columna de entrada o valor
el valor especificado entrada, valor
Nombre Descripción Argumentos Salida
si la columna de
entrada es nula, de
lo contrario
devuelve el valor de
la columna de
entrada
Asigne un valor
SetNull nulo a la columna de- -
destino

true = 1

false = 0

Funciones de número
Última actualización: 2021-02-28

La siguiente tabla muestra una lista de funciones disponibles en la categoría Número (los corchetes indican que
un argumento es opcional):

Nombre Descripción ArgumentosSalida

Devuelve la
mantisa de un número
MantissaFromDecimal resultado (dfloat)
decimal (decimal)
proporcionado
Devuelve la
mantisa de un número
MantissaFromDFloat resultado (dfloat)
dfloat (dfloat)
proporcionado

Funciones Sin formato

Última actualización: 2021-02-28

La siguiente tabla muestra una lista de funciones disponibles en la categoría Sin formato (los corchetes indican
que un argumento es opcional):

Nombre DescripciónArgumentosSalida
Devuelve la
serie de
longitud de
RawLength entrada Resultado (int32)
una serie sin
(raw)
formato

Funciones de serie
Última actualización: 2021-02-28

La siguiente tabla muestra una lista de funciones disponibles en la categoría Serie (los corchetes indican que un
argumento es opcional):

Nombre Descripción Argumentos Salida

Devuelve si la serie
proporcionada está
AlNum formada por serie (string) true/false (int8)
caracteres
alfanuméricos

Devuelve 1 si la
Alpha serie es totalmente serie (string) resultado (int8)
alfabética

Devuelve la serie
después de reducir
CompactWhiteSpace todos los espacios en serie (string) resultado (string)
blanco seguidos en
un único espacio

serie11
(string)
Compara dos series
Compare para poder serie2 resultado (int8)
ordenarlas (string)

[justificación
(L o R)]
Comparación de dos
series que distingue serie1 (string)
ComparNoCase resultado (int8)
entre mayúsculas y serie2 (string)
minúsculas

serie1 (string)
Compara el primer serie2 (string)
ComparNum carácter n de dos resultado (int8)
series longitud
(int16)
Comparación sin
tener en cuenta las serie1 (string)
mayúsculas y serie2 (string)
CompareNumNoCase resultado (int8)
minúsculas del
primer carácter n de longitud
dos series (int16)

fromlist
Convierte los
(string)
Convert caracteres resultado (string)
especificados de una
tolist (string)
serie en caracteres
Nombre Descripción Argumentos Salida

de sustitución expresión
designados (string)
Número de recuento serie (serie)
de veces que una
Count resultado (int32)
subserie aparece en subserie
una serie (string)
Número de recuento serie (serie)
de campos
Dcount resultado (int32)
delimitados en una delimitador
serie (string)
Cambiar todas las
letras en mayúscula
DownCase serie (string) resultado (string)
de una serie a
minúscula

Entrecomillar una
DQuote serie (string) resultado (string)
serie

serie (string)
delimitador
Devuelve una o más (string)
Campo subseries resultado (string)
delimitadas aparición
(int32)
[número
(int32)]
serie (string)
Encuentra la
subserie
posición del carácter
Index (string) resultado (int32)
inicial de una
aparición
subserie
(int32)

Caracteres n situadosserie (serie)

Left más a la izquierda de resultado (string)
una serie número
(int32)
Longitud de la serie
Len serie (string) resultado (int32)
en caracteres

Devuelve 1 si la
serie se puede
Num serie (string) resultado (int8)
convertir en un
número

Devuelve la serie serie (serie)

rellenada con el
PadString carácter de relleno longitud de resultado (string)
opcional y la relleno
longitud opcional (int32)
Nombre Descripción Argumentos Salida

Caracteres n situadosserie (serie)

Right más a la derecha de resultado (string)
una serie número
(int32)
Devuelve una serie
que identifica un
conjunto de palabras
que fonéticamente
(aproximadamente)
Soundex son parecidas serie (string) resultado (string)
basándose en un
estándar, abre el
algoritmo para la
evaluación
SOUNDEX

Devuelve una serie

longitud
Space de caracteres de resultado (string)
(int32)
espacio N

Delimita una serie

Squote serie (string) resultado (string)
con comillas simples

serie (serie)
Str Repite una serie resultado (string)
repeticiones
(int32)
Devuelve la serie
después de quitar
StripWhiteSpace serie (string) resultado (string)
todos los espacios en
blanco de la serie

Elimina todos los

espacios y serie (string)
tabulaciones [stripchar
Trim iniciales y finales, (string)] resultado (string)
además de reducir [opciones
todas las apariciones (string)]
internas a una

Elimina todas las

TrimB tabulaciones y los serie (string) resultado (string)
espacios finales

Elimina todas las

TrimF tabulaciones y los serie (string) resultado (string)
espacios iniciales

Devuelve una serie

Trim Leading con los espacios en
serie (string) resultado (string)
Trailing blanco iniciales y
finales eliminados
Nombre Descripción Argumentos Salida

Cambia todas las

letras minúsculas a
Upcase serie (string) resultado (string)
mayúsculas de una
serie

true = 1

false = 0

Las posibles opciones para la función Trim son:

 L Elimina las apariciones iniciales del carácter.

 T Elimina las apariciones finales del carácter.
 B Elimina las apariciones iniciales y finales del carácter.
 R Elimina las apariciones iniciales y finales del carácter y reduce las apariciones a una sola aparición.
 A Elimina todas las apariciones del carácter.
 F Elimina las tabulaciones y los espacios en blanco iniciales.
 E Elimina las tabulaciones y los espacios en blanco finales.
 D Elimina las tabulaciones y los espacios en blanco iniciales y finales y reduce los espacios y las tabulaciones a
solo un espacio y una tabulación.

Función Vector
Última actualización: 2021-02-28

La siguiente función se puede utilizar en expresiones para acceder a un elemento de una columna de vector. El
índice de vector empieza en 0.

Nombre DescripciónArgumentosSalida
Accede a un índice de
ElementAtelemento de columna de elemento de vector
un vector entrada (int)

Esto se puede utilizar como parte de una expresión o bien como toda la expresión. Por ejemplo, una expresión
para añadir 1 al tercer elemento de una columna de entrada de vector 'InLink.col1' seria:

ElementAt(InLink.col1, 2) + 1

Funciones de tipo de conversión

Última actualización: 2021-02-28

La siguiente tabla muestra una lista de funciones disponibles en la categoría Tipo de conversión (los corchetes
indican que un argumento es opcional):
Nombre Descripción Argumentos Salida

Devuelve una
representación fecha
DateToString de serie de un resultado (string)
dato [formato
proporcionado (string)]

Devuelve el
decimal
decimal
proporcionado
(decimal)
en una
[rtype
DecimalToDecimal representación resultado (decimal)
(string)]
decimal con la
[packedflag
escala y la
(int8)]
precisión
especificados

Devuelve el
decimal
número
proporcionado
DecimalToDFloat (decimal) resultado (dfloat)
en una
["fix_zero"]
representación
dfloat

Devuelve una
representación número
DecimalToString de serie de un (decimal) resultado (string)
decimal ["fix_zero"]
proporcionado

Devuelve el
dfloat número
proporcionado (dfloat)
DfloatToDecimal resultado (decimal)
en [rtype
representación (string)]
decimal

Devuelve el
dfloat
proporcionado
en su número
representación (dfloat)
DfloatToStringNoExp resultado (string)
de serie sin escala
exponente, (string)
utilizando la
escala
especificada

Devuelve si la
serie tipo (string)
IsValid proporcionada formato resultado (int8)
es válida para el (string)
tipo
proporcionado.
Nombre Descripción Argumentos Salida

Los tipos
válidos son
"date",
"decimal",
"dfloat",
"sfloat", "int8",
"uint8", "int16",
"uint16",
"int32",
"uint32",
"int64",
"uint64", "raw",
"string", "time",
"timestamp".
"ustring"

Devuelve una fecha

fecha de la serie (string)
StringToDate proporcionada fecha
en el formato formato
proporcionado (string)

Devuelve una
serie
serie (string)
proporcionada
StringToDecimal [rtype resultado (decimal)
en
(string)]
representación
decimal

Devuelve una
serie en una
StringToRaw serie (string) resultado (raw)
representación
sin formato

Devuelve una
representación serie (string)
StringToTime de hora de una [formato hora
serie (string)]
proporcionada

Devuelve una
representación
serie (string)
de indicación de
StringToTimestamp [formato indicación de fecha y hora
fecha y hora de
(string)]
una serie
proporcionada

Devuelve una
fecha para la indicación
TimestampToDate indicación de de fecha y fecha
fecha y hora hora
proporcionada
Nombre Descripción Argumentos Salida

Devuelve una
indicación
representación
de fecha y
de serie de una
TimestampToString hora resultado (string)
indicación de
[formato
fecha y hora
(string)]
proporcionada

Devuelve la
hora de una indicación
TimestampToTime indicación de de fecha y hora
fecha y hora hora
proporcionada

Devuelve la
representación hora
TimeToString de serie de una [formato resultado (string)
hora (string)]
proporcionada

Devuelve un
ustring de una
serie
proporcionada,
opcionalmente
serie (string)
utilizando la
StringToUstring [,mapname resultado (ustring)
correlación
(string)]
especificada (de
lo contrario
utiliza el
proyecto
predeterminado)

Devuelve una
serie de un
ustring
proporcionado,
opcionalmente serie(ustring)
utilizando la
UstringToString resultado (string)
correlación [,mapname
especificada (de (string)]
lo contrario
utiliza el
proyecto
predeterminado)

Rtype. El argumento rtype es una serie y debería contener uno de los elementos siguientes:

 ceil. Redondea el campo de origen hacia la infinidad positiva, por ejemplo: 1,4 -> 2, -1,6 -> -1.
 floor. Redondea el campo de origen hacia la infinidad negativa, por ejemplo: 1,6 -> 1, -1,4 -> -2.
 round_inf. Redondea o trunca el campo de origen hacia el valor representable más cercano, rompiendo lazos
redondeando valores positivos hacia la infinidad positiva y valores negativos hacia la infinidad negativa, por
ejemplo: 1,4 -> 1, 1,5 -> 2, -1,4 -> -1, -1.5 -> -2.
  trunc_zero. Descarta los dígitos fraccionarios que hay a la derecha del dígito fraccionario de más a la derecha
soportado por el destino, independientemente del signo. Por ejemplo, si el destino es un entero, se truncan
todos los dígitos fraccionarios. Si el destino es otro decimal con una escala inferior, se redondea o se trunca el
tamaño de escala del decimal de destino, por ejemplo: 1,6 -> 1, -1,6 -> -1.

Para la función DecimalToDecimal, el valor predeterminado del argumento rtype es round_inf. Para otras
funciones, debe especificar un valor para el campo del argumento rtype.

Serie de formato. Las funciones Date, Time y Timestamp que cogen un formato de serie (por ejemplo
timetostring(time, stringformat)) necesitan tener el formato de fecha especificado. Las series de formato se
describen en Formatos de fecha y hora.

Donde sus fechas, horas e indicaciones de fecha y hora se convertirán a ustrings o a partir de ustrings,
InfoSphere DataStage adoptará estos valores automáticamente. En estos casos los separadores en la serie de
formato (por ejemplo, `:' o `-') pueden ser caracteres Unicode.

fix_zero. De forma predeterminada, los números decimales compuestos todos por ceros se tratan como no
válidos. Si la serie fix_zero se especifica como un argumento secundario, todos los valores decimales cero se
tratan como válidos.

Funciones de tipo "casting"

Última actualización: 2021-02-28

Hay un tipo de clase especial de función de conversión de tipos que es de ayuda para la realización de cálculos
matemáticos utilizando campos numéricos. Por ejemplo, si tiene un cálculo que utiliza una columna de entrada
de tipo flotante derivada de una columna de entrada de tipo entero en una etapa Parallel Transformer, el
resultado derivará en un entero aunque sea del tipo flotante. Si desea obtener un resultado no integral para un
cálculo que utiliza operandos integrales, puede utilizar las siguientes funciones (que actúan de forma similar a
"casting" en C) para lanzar operandos enteros en operandos no integrales:

Nombre Descripción ArgumentosSalida

Trata el
número
número
AsDoubleproporcionado número (double)
(number)
como un
doble
Trata el
número
número
AsFloat proporcionado número (float)
(number)
como un
flotante
Trata el
número
número
AsInteger proporcionado número (int)
(number)
como un
entero
Funciones de programa de utilidad
Última actualización: 2021-02-28

La siguiente tabla muestra una lista de funciones disponibles en la categoría Programa de utilidad (los corchetes
indican que un argumento es opcional):

Nombre Descripción Argumentos Salida

Devuelve el
valor de la variable de
GetEnvironment resultado (string)
variable de entorno (string)
entorno
Devuelve el
valor de la
columna clave
sucedánea
para el
NextSKChain registro valor (number)resultado (int64)
siguiente de la
cadena, o
el valor para
el registro más
reciente.
Devuelve el
valor de la
NextSurrogateKeysiguiente Ninguno resultado (int64)
clave
sucedánea
Devuelve el
valor de la
columna clave
sucedánea
para el
PrevSKChain registro valor (number)resultado (int64)
anterior de la
cadena, o
el valor para
el primer
registro.

Fuente: https://www.ibm.com/docs/es/iis/11.5?topic=specifications-functions-used-in-infosphere-
datastage-qualitystage