OPUS AEC 10 CMS 2009 2010 Descripción de la librería de funciones disponibles


· Funciones de Fecha y Hora

HORA

Devuelve la hora actual del sistema, como una cadena de caracteres

SINTAXIS: [HORA()]

ARGUMENTO: Sin Argumento

EJEMPLO: [HORA()]

DEVUELVE: 05:10:07 p.m

FECHA

Devuelve la fecha actual del sistema, como una cadena de caracteres

SINTAXIS: [FECHA()]

ARGUMENTO: Sin Argumento

EJEMPLO: [FECHA()]

DEVUELVE: 07/09/2000

IMPRIMEFECHA

SINTAXIS: Devuelve la fecha en la que se hizo la impresión del reporte.

ARGUMENTO: Sin Argumento

EJEMPLO: [IMPRIMEFECHA()]

DEVUELVE: 07/09/2000

EXTRAERDIA

Devuelve el día del mes (un número del 1 al 31) correspondiente al número que representa una fecha.

SINTAXIS: [EXTRAERDIA(FECHA)]

ARGUMENTO: Recibe una fecha ya sea la del sistema o preestablecida en los parámetros de la obra.

EJEMPLO: [EXTRAERDIA(Fecha inicio de la obra)]

DEVUELVE: 15

EJEMPLO: [EXTRAERDIA(FECHA)]

DEVUELVE: 07/09/2000

EXTRAERMES

Devuelve el mes (un número de 1..12) de una fecha dada, o una cadena dada.

SINTAXIS: [EXTRAERMES(FECHA)]

ARGUMENTO: Recibe una fecha ya sea la del sistema o preestablecida en los parámetros de la obra.

EJEMPLO: [EXTRAERMES(Fecha de concurso)]

DEVUELVE: 9 (es decir el noveno mes el año)

EXTRAERAÑO

Obtiene únicamente el año de una fecha dada.

SINTAXIS: [EXTRAERAÑO(FECHA)]

ARGUMENTO: Recibe una fecha ya sea la del sistema o preestablecida en los parámetros de la obra.

EJEMPLO: [EXTRAERAÑO(Fecha de inicio de la obra)]

DEVUELVE:2000 (el año de la fecha del inicio de la obra)

DIASEMANA

Devuelve el número que le corresponde al día de la semana de una fecha dada (1=Domingo, 2=Lunes, 3=Martes, etc)

SINTAXIS: [DIASEMANA(FECHA)]

ARGUMENTO: Recibe una fecha ya sea la del sistema o preestablecida en los parámetros de la obra.

EJEMPLO: Obtener el día de la semana de la fecha de inicio de una obra, si ésta fue el 1º de Febrero del 2000, entonces: [DIASEMANA(Fecha de Inicio de la Obra)]

DEVUELVE: 3, es decir que el día 1º de Febrero de 2000, fue Martes.

EJEMPLO: Obtener el día de la semana de la fecha de inicio de una obra, si ésta fue el 1º de Febrero del 2000 en letra, entonces: [[DIACADENA(DIASEMANA(fecha()))])]

DEVUELVE: Martes, lo que significa que es el día de la semana al que pertenece la fecha 1º de Febrero del 2000.

DIACADENA

Devuelve el nombre del día para un número dado, donde 1 = Domingo; Lunes = 2; Martes = 3; Miércoles = 4; …etc.

SINTAXIS: [DIACADENA(DIA_SEMANA)]

ARGUMENTO: Recibe un número que corresponde al nombre de un día de la semana.

EJEMPLO: [DIACADENA(2)]

DEVUELVE: Lunes

MESCADENA

Devuelve el nombre del mes para un número dado ( 1 = Enero, 2 = Febrero, 3 = Marzo, etc)

SINTAXIS: [MESCADENA(MES)]

ARGUMENTO: Recibe un número (Enero=1, Febrero=2, etc) que corresponde al nombre de un mes.

EJEMPLO: [MESCADENA(5)]

DEVUELVE: Mayo

· Funciones matemáticas

ENTERO

Devuelve la parte entera de un número decimal o flotante

SINTAXIS: [ENTERO(CANTIDAD)]

ARGUMENTO: Recibe un número con punto decimal o campo.

EJEMPLO: [ENTERO(58.236)]

DEVUELVE: El número entero, en este caso 58.

FRACCIONAL

Devuelve la parte fraccional de un número dado.

SINTAXIS: [FRACCIONAL(CANTIDAD)]

ARGUMENTO: Recibe un número con punto decimal.

EJEMPLO: [FRACCIONAL(369/985)]

DEVUELVE: El número decimal, en este caso 0.3746192893

RAÍZ

Devuelve la raíz cuadrada de un número dado.

SINTAXIS: RAÍZ(CANTIDAD)]

ARGUMENTO: Recibe un valor o campo de número.

EJEMPLO: [RAÍZ(526)]

DEVUELVE: 22.9346

DIVIDE

Devuelve la división entre el número X entre el número Y.

Donde X es el Divisor y el Dividendo es Y.

SINTAXIS: [DIVIDE(X,Y)]

ARGUMENTO: Recibe un valor o campo de número.

EJEMPLO: [DIVIDE(PRECIO, NÚMERO)]

DEVUELVE: El resultado de la división de PRECIO / NÚMERO, donde el precio es un número de la columna precio de una vista de OPUS y número puede ser 1.15, si es que se desea saber el importe sin IVA de un precio dado, por ejemplo.

EJEMPLO: [DIVIDE(1258, 1.15)]

DEVUELVE: 1093.9130

ABSOLUTO

Devuelve el valor absoluto de un número dado, es decir sin signo.

SINTAXIS: [ABSOLUTO(NÚMERO)]

ARGUMENTO: Recibe un valor o campo de número.

EJEMPLO: [ABSOLUTO(-358.5469)]

DEVUELVE: 358.5469

REDONDEA

Devuelve un número redondeado al número de decimales que se especifica.

SINTAXIS: [REDONDEA(NUMERO,DECIMALES)

ARGUMENTO: Recibe un número dado o un campo preseleccionado.

EJEMPLO: [REDONDEA(0.17965,1)]

DEVUELVE: 0.2

· Funciones estadísticas

SUMA

Devuelve la suma de datos dentro de un rango especificado.

SINTAXIS: [SUMA(NUMERO)]

ARGUMENTO: Recibe un valor y/o campo de número.

EJEMPLO: Obtener el importe total de una columna con un incremento de un 15%, entonces: [SUMA(importe*1.15)]

DEVUELVE: La suma de los importes de una columna más el 15%.

CUENTA

Incrementa por cada interacción. Este función puede ser útil para enumerar los elementos que se están imprimiendo.

SINTAXIS: [CUENTA()]

ARGUMENTO: Sin Argumento

EJEMPLO: Asignar consecutivo a la cantidad de conceptos, insumos, etc.

DEVUELVE: Un número de forma consecutiva al listado.

PROMEIO

Devuelve el promedio de un valor NÚMERO. La función es útil para hacer promedios por columna.

SINTAXIS: [PROMEDIO(NÚMERO)]

ARGUMENTO: Recibe campos de NÚMERO.

EJEMPLO: Promedio de una columna precio unitario, [PROMEDIO(precio unitario)]

DEVUELVE: El valor promedio de los valores contenidos en la columna.

ASUMA

Acumula la suma del número dado, este número puede ser un campo.

SINTAXIS: [ASuma(NÚMERO)]

ARGUMENTO: Un número ó un campo de la base de datos. Si el valor de este argumento es un campo, la suma se efectuará por cada interacción.

EJEMPLO: Obtener valor de importes acumulados, por ejemplo: [ASuma(importe)]

DEVUELVE: El valor de los importes acumulados por hoja.

· Funciones Lógicas

SI

Devuelve un valor único si a una condición específica se evalúa como VERDADERO y otro valor si se evalúa como FALSO, siendo de ayuda para filtrar información específica.

SINTAXIS: [SI(PRUEBA_LOGICA, VALOR_SI_VERDADERO, VALOR_SI_FALSO)]

ARGUMENTO: Cualquier valor o expresión que pueda evaluarse como VERDADERO o FALSO

EJEMPLO: Obtener los precios mayores a una cantidad específica, por ejemplo a 1000 pesos, y que solo refleje los que encuentre mayores a esta cantidad, entonces: [Si(Precio>1000,’ ‘,Precio)]

DEVUELVE: Solamente los precios que encuentre, mayores a 1000.

· Funciones de Información

PÁGINA

Devuelve el número de página actual.

SINTAXIS: [PÁGINA()]

ARGUMENTO: Sin Argumento

EJEMPLO: [PÁGINA()]

DEVUELVE: El número de página de manera consecutiva.

· Otras Funciones

CADENA

Convierte un número a cadena.

SINTAXIS: [CADENA(NÚMERO)]

ARGUMENTO: Número

EJEMPLO: Obtener el valor de Depreciación de un reporte de Costo horario (D=(Vn-Vr)/Ve): Entonces sustituir la fórmula con las funciones siguientes: [Cadena(Valor de adquisición)+’-‘+Cadena(Valor de Rescate)+’/’+Cadena(Vida económica)]

DEVUELVE: Como una cadena de número, el valor del campo que se insertó, en este caso: 0-0/1600.

NUMLETRA

Convierte un numero a cadena, reflejando solamente el valor de un número entero.

SINTAXIS: [NUMLETRA(NÚMERO) ]

ARGUMENTO: Recibe un valor o campo de número.

EJEMPLO: Obtener en letra el valor de una cantidad asignada, entonces: [NUMLETRA(Precio Unitario) ]

DEVUELVE: Solamente DOSCIENTOS CINCUENTA Y SEIS, si el valor del Precio Unitario es 256.89

LETRAMN

Convierte un numero a letra usando la información de la moneda nacional de la obra.

SINTAXIS: [LETRAMN(NÚMERO) ]

ARGUMENTO: Recibe un valor o campo de número.

EJEMPLO: Obtener en letra el valor de 777.85, el cual es un precio unitario [NUMLETRA(Precio Unitario) ]

DEVUELVE: SETECIENTOS SETENTA Y SIETE PESOS 85 /100 M.N.

LETRAME

Convierte un numero a letra usando la información de los parámetros la moneda extranjera de la obra.

SINTAXIS: [LETRAME(NÚMERO) ]

ARGUMENTO: Recibe un valor o campo de número.

EJEMPLO: Obtener en letra el valor de 45.10, el cual es un precio unitario en moneda extranjera [NUMLETRA(Precio Unitario ME) ]

DEVUELVE: CUARENTA Y CINCO PESOS 10 Ctvs.

¿Necesitas ayuda? Chatea ahora por WhatsApp