10. Conversión Tipos

Contenido

⁠
Tabla Conversión de Tipos⁠
⁠

⁠
@Str ⁠
⁠

⁠
@Val⁠
⁠

⁠
@Ctod⁠
⁠

⁠
@CtoT⁠
⁠

⁠
@Dtoc⁠
⁠

⁠
@Jtod⁠
⁠

⁠
@Dtoj⁠
⁠

⁠
@Ttoc⁠
⁠

⁠
@Ntod⁠
⁠

Tabla Conversión de Tipos

Tabla Conversión de Tipos

Tipo Origen

Tipo Destino

Función

Numérico

Carácter

@Str

Numérico

Fecha

@Ntod

Carácter

Numérico

@Val

Carácter

Fecha

@Ctod

Carácter

Hora

@Ctot

Fecha

Carácter

@Dtoc

Hora

Carácter

@Ttoc

⁠

@Str

Convierte un número o campo Numérico en una cadena (campo Caracter). Vea a su vez la función @Val que convierte una cadena en un número.

Esta @Función puede ser utilizada en combinación con un número o con otras @Funciones que requieran una cadena como parámetro, tal como @Mid para obtener una serie de dígitos específicos de un campo Numérico.

Sintaxis

@Str(número1, número2, número3)

Retorno

(Cadena) Retorna el texto correspondiente al valor numérico suministrado.

Parámetros

Número1: (Numérico) es la expresión o campo Numérico a ser convertido en un campo Caracter.

Número2: (Numérico) es la longitud de la cadena de salida.

Número3: (Numérico) es la cantidad de decimales requerida.

Ejemplo

Se parte del campo de monto(MONTO) que es representado por una cantidad numérica:

504243.44

Se desea convertir este monto a un formato textual, con 20 caracteres máximo y 2 posiciones decimales:

504,243.44

Para esto se invoca la función a través de los siguientes parámetros:

@Str(MONTO, 20, 2)

Ejemplo con Data

MONTO

@Str(MONTO, 20, 2)

504243.44

504,243.44

⁠

@Val

Convierte un número guardado como caracter al formato numérico. Los datos numéricos que no se usan para cálculos se guardan a menudo en formato Caracter, como por ejemplo, los números de cuenta. Sin embargo, para llevar a cabo algunas pruebas de auditoría tales como buscar omisiones en una secuencia, será necesario convertir estos campos al formato numérico. Para ello puede utilizarse la función @Val.

Sintaxis

@Val(cadena)

Retorno

(Numerico) Retorna el valor numérico de la cadena suministrada

Parámetros

Cadena: (Caracter) es la expresión o campo Caracter que contiene los números a ser convertidos en formato numérico.

Ejemplo

Se parte del campo de monto(MONTO_TXT) que es representado por un texto que implica una cantidad numérica:

504243.44

Se desea convertir este monto a un formato Numérico en IDEA:

504,243.44

Para esto se invoca la función a través de los siguientes parámetros:

@Val(MONTO_TXT)

Ejemplo con Data

MONTO_TXT

@Val(MONTO_TXT)

504243.44

504,243.44

⁠

@Ctod

Convierte un campo de fechas guardadas como Caracter en un campo tipo Fecha con el Formato de Fecha de IDEA (AAAAMMDD).

Sintaxis

@Ctod(cadena, máscara)

Retorno

(Fecha) Retorna la fecha en formato Fecha

Parámetros

Cadena: (Caracter) La expresión caracter del campo a ser convertido en un campo tipo Fecha.

Máscara: (Caracter) es el formato actual de la fecha a convertir.

Ejemplo

Se parte del campo de fecha(FECHA_TXT) que es representado por un texto que implica una fecha en formato DD/MM/AAAA:

19/01/2025

Se desea convertir este monto a un formato Fecha en IDEA. Para esto se invoca la función a través de los siguientes parámetros:

@Ctod(FECHA_TXT,"DD/MM/AAAA")

Ejemplo con Data

FECHA_TXT

@Ctod(FECHA_TXT,"DD/MM/AAAA")

19/01/2025

⁠

@CtoT

Convierte un campo Carácter con valores de horas guardados como una cadena a un campo de tipo Hora con el formato (HH:MM:SS).

Sintaxis

@Ctod(Cadena, Máscara)

Retorno

(Hora) Retorna la hora en formato Hora

Parámetros

Cadena: (Caracter) la expresión carácter o campo a ser convertido en un campo tipo Hora.

Máscara: (Caracter) es el formato actual de la hora a convertir.

Ejemplo

Se parte del campo de hora(HORA_TXT) que es representado por un texto que implica una hora en formato HH:MM:SS TT:

08:30:04 am

Se desea convertir este monto a un formato Hora en IDEA. Para esto se invoca la función a través de los siguientes parámetros:

@ctot(HORA_TXT ,"HH:MM TT")

Ejemplo con Data

HORA_TXT

@ctot(HORA_TXT ,"HH:MM TT")

08:30:04 am

8:30:04 AM

⁠

@Dtoc

Convierte un campo Fecha guardado en formato de 'Fecha'' de IDEA, en un campo con formato Fecha según la máscara especificada. Es la función inversa a la función @Ctod. Puede ser útil para visualizar un campo Fecha en un formato específico, tal como 12-MAR-1999 a los efectos de un reporte.

Sintaxis

@Dtoc(fecha, máscara)

Retorno

(Caracter) Retorna la fecha en formato Caracter

Parámetros

Fecha: (Fecha) es la fecha o campo a ser convertido en Caracter.

Máscara: (Caracter) es el formato requerido para la fecha.

Ejemplo

Se parte del campo de fecha(FECHA) que es representado por una fecha en formato IDEA:

18/06/2025

Se desea convertir este monto a un formato Caracter en IDEA. Para esto se invoca la función a través de los siguientes parámetros:

@Dtoc(FECHA,"DD/MM/AAAA")

Ejemplo con Data

FECHA

Ecuación

Resultado

18/06/2025

@Dtoc(FECHA,"DD/MM/AAAA")

18/06/2025

@Dtoc(FECHA,"DD-MM-AAAA")

18-06-2025

18/06/2025

@Dtoc(FECHA,"DD/MMM/AAAA")

18/JUN/2025

⁠

@Jtod

Muchos sistemas computarizados guardan las fechas en formato de fecha Juliano. La fecha Juliana es la cantidad de días desde una fecha base arbitraria. Esta @Función devuelve la fecha en el formato de "Fecha" de IDEA (AAAAMMDD).

Sintaxis

@Jtod(número)

Retorno

(Fecha) Retorna la fecha juliana en formato Fecha

Parámetros

Número: (Numérico) es la fecha Juliana requerida en formato de Fecha de IDEA.

Ejemplo

Se parte del campo de fecha(FECHA_J) que es representado por un numero que implica una fecha en formato juliano:

739420

Se desea convertir este monto a un formato Fecha en IDEA:

17/06/2025

Para esto se invoca la función a través de los siguientes parámetros:

@Jtod(FECHA_J)

Ejemplo con Data

FECHA_J

@Jtod(FECHA_J)

739420

17/06/2025

⁠

@Dtoj

Convierte una fecha en formato 'Fecha'' de IDEA a un número Juliano. Es la función inversa a la función @Jtod. Las fechas anteriores al 1 de enero de 0001 producirán un error de sintaxis.

Sintaxis

@Dtoj(fecha)

Retorno

(Numerico) Retorna la fecha en formato juliano

Parámetros

Fecha: (Fecha) es el campo Fecha o constante del cual desea obtener el número juliano.

Ejemplo

Se parte del campo de fecha(FECHA) que es representado por una fecha en formato IDEA:

17/06/2025

Se desea convertir este monto a un formato juliano en IDEA:

739420

Para esto se invoca la función a través de los siguientes parámetros:

@Dtoj(FECHA)

Ejemplo con Data

FECHA

@Dtoj(FECHA)

17/06/2025

739420

⁠

@Ttoc

Convierte una hora o número en una cadena con el formato HH:MM:SS.

Sintaxis

@Ttoc(Hora)

Retorno

(Caracter) Retorna la hora en formato Hora

Parámetros

Hora: (Hora) es la constante de hora, campo Hora o campo Numérico a ser convertido al formato de cadena HH:MM:SS. Los valores en un campo Numérico son interpretados como la cantidad de segundos. Por ejemplo el valor numérico 86400 es leído como 86400 segundos o 24 horas, o 4832 es una hora, 20 minutos y 32 segundos.

Ejemplo

Se parte del campo de hora(HORA) que es representado por una hora en formato IDEA:

08:30:04 am

Se desea convertir este valor a un formato Caracter en IDEA.

Para esto se invoca la función a través de los siguientes parámetros:

@Ttoc(HORA)

Ejemplo con Data

HORA

@Ttoc(HORA)

8:30:04 AM

⁠

@Ntod

Convierte un campo con fechas guardadas con tipo Numérico en un campo tipo Fecha con el Formato de Fecha de IDEA (AAAAMMDD).

Sintaxis

@Ntod(Número, Máscara)

Retorno

(Fecha) Retorna la fecha juliana en formato Fecha

Parámetros

Cadena: (Numérico) La expresión numérica del campo a ser convertido en un campo tipo Fecha.

Máscara: (Caracter) es el formato actual de la fecha a convertir.

Ejemplo

Se parte del campo de fecha(FECHA_NUM) que es representado por un numero que implica una fecha en formato DDMMAAAA:

19012025

Se desea convertir este monto a un formato Fecha en IDEA:

19/01/2025

Para esto se invoca la función a través de los siguientes parámetros:

@Ntod(FECHA_NUM, "DDMMAAAA")

Ejemplo con Data

FECHA_NUM

@Ntod(FECHA_NUM, "DDMMAAAA")

19012025

19/01/2025

⁠