FUNCIONES CRYSTAL REPORT

22
FUNCIONES CRYSTAL REPORT Las funciones son subrutinas o procedimientos integrados utilizados para evaluar, calcular o transformar datos. Cuando especifica una función, Crystal Reports realiza el conjunto de operaciones que integran la función sin tener que especificar cada operación por separado. De esta forma, una función es una especie de abreviatura que le permite crear fórmulas de una manera más rápida y sencilla. Se incluyen ejemplos sencillos de cada función. Además, se incluyen referencias de muchas de las funciones a las fórmulas del tema Fórmulas en acción de la Ayuda en pantalla de Crystal Reports (busque Fórmulas en acción). Fórmulas en acción muestra usos avanzados de las funciones para resolver problemas complejos de la vida real. Abs (x) Argumentos x es cualquier número.Valores que devuelve Valor absoluto de x. Acción Abs devuelve el valor absoluto de x, eliminando cualquier valor negativo. Aged0To30Days Aged31To60Days Aged61To90Days Valores que devuelve Ninguno Acción Especifica un intervalo de valores de las fechas comprendidas dentro de un periodo determinado de tiempo anterior a la fecha actual. Si la fecha actual es 30/12/98, Aged0To30Days especifica el periodo desde el 1/12/98 hasta la fecha actual, Aged31To60Days especifica el periodo comprendido entre el 1/11/98 y el 30/11/98, y Aged61To90Days especifica el periodo comprendido entre el 2/10/98 y el 31/10/98.

Transcript of FUNCIONES CRYSTAL REPORT

Page 1: FUNCIONES CRYSTAL REPORT

FUNCIONES CRYSTAL REPORT

Las funciones son subrutinas o procedimientos integrados utilizados para evaluar, calcular o transformar datos. Cuando especifica una función, Crystal Reports realiza el conjunto de operaciones que integran la función sin tener que especificar cada operación por separado. De esta forma, una función es una especie de abreviatura que le permite crear fórmulas de una manera más rápida y sencilla. Se incluyen ejemplos sencillos de cada función. Además, se incluyen referencias de muchas de las funciones a las fórmulas del tema Fórmulas en acción de la Ayuda en pantalla de Crystal Reports (busque Fórmulas en acción). Fórmulas en acción muestra usos avanzados de las funciones para resolver problemas complejos de la vida real.

Abs (x) Argumentos x es cualquier número.Valores que devuelve

Valor absoluto de x.

Acción Abs devuelve el valor absoluto de x, eliminando cualquier valor negativo.Aged0To30DaysAged31To60DaysAged61To90Days Valores que devuelve

NingunoAcción

Especifica un intervalo de valores de las fechas comprendidas dentro de un periodo determinado de tiempo anterior a la fecha actual. Si la fecha actual es 30/12/98, Aged0To30Days especifica el periodo desde el 1/12/98 hasta la fecha actual, Aged31To60Days especifica el periodo comprendido entre el 1/11/98 y el 30/11/98, y Aged61To90Days especifica el periodo comprendido entre el 2/10/98 y el 31/10/98.

AllDatesFromToday Valores que devuelve NingunoAcción

Especifica un intervalo de valores de fecha que incluye cualquier fecha desde el día actual hasta cualquier valor de fecha futuro que pueda aparecer en el campo. AllDatesFromToday incluye el día actual.

AllDatesFromTomorrow Valores que devuelve NingunoAcción

Page 2: FUNCIONES CRYSTAL REPORT

Especifica un intervalo de valores de fecha desde el día actual. AllDatesFromTomorrow no incluye el día actual, pero sí incluye cualquier fecha futura.

AllDatesToToday Valores que devuelve NingunoAcción

Especifica un intervalo de valores de fecha que incluye todos los días anteriores al día actual. AllDatesToToday incluye el día actual.

AllDatesToYesterday Valores que devuelve Ninguno

Acción

Especifica un intervalo de valores de fecha que incluye todos los días anteriores hasta el día anterior al día actual. AllDatesToYesterday incluye todas las fechas anteriores al día de hoy, pero no incluye el día actual.

Average (campo)Average (campo, campocond)Average (campo, campocond, cond)Average (x) Acción

Crystal Reports le permite calcular el promedio de los valores que aparecen en el informe. Por ejemplo:

· Si un informe de ventas incluye un campo que muestra el importe de cada pedido, puede calcular el promedio de todos los pedidos que aparecen en el informe (promedio total general). Vea Función Sum (campo), más adelante en este mismo capítulo.

· Si divide los pedidos en grupos (por ejemplo, pedidos agrupados según el estado desde el que se realizaron), puede calcular el pedido promedio por grupo (en este caso, por estado). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo.

· Si divide los pedidos en función de la fecha o de valores Booleanos (por ejemplo, pedidos agrupados por el mes en el que se realizaron), puede calcular el pedido promedio de cada grupo en función de la variación del campo de fecha o Booleano (en este caso, por mes). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo.

Page 3: FUNCIONES CRYSTAL REPORT

· Si especifica una matriz de valores individuales, también puede calcular el valor promedio del conjunto. Vea Función Sum (x), más adelante en este mismo capítulo.

BeforeReadingRecords Valores que devuelve Ninguno

Acción

Especifica que la fórmula se va a evaluar antes de leer los registros de la base de datos.

Calendar1stHalfCalendar2ndHalf Valores que devuelve Ninguno

Acción

Especifica un intervalo de valores de fecha que incluye todas las fechas comprendidas en el primer o el segundo semestre del año, respectivamente. El primer semestre del año incluye todas las fechas desde el 1 de enero hasta el 30 de junio. El segundo semestre del año incluye todas las fechas desde el 1 de julio hasta el 31 de diciembre.

Calendar1stQtrCalendar2ndQtr,Calendar3rdQtrCalendar4thQtr Valores que devuelve NingunoAcción

Especifica un intervalo de valores de fecha que comprende el primer, segundo, tercer o cuarto trimestre del año. El primer trimestre del año incluye desde el 1 de enero hasta el 31 de marzo. El segundo trimestre del año incluye todas las fechas desde el 1 de abril hasta el 30 de junio. El tercer trimestre del año incluye desde el 1 de julio hasta el 30 de septiembre. El cuarto trimestre del año incluye desde el 1 de octubre hasta el 31 de diciembre.

Count (campo)Count (campo, campocond)Count (campo, campocond, cond)Count (x) Acción

Crystal Reports le permite contar los valores que aparecen en el informe. Por ejemplo:

Page 4: FUNCIONES CRYSTAL REPORT

· Si un informe de ventas incluye todos los pedidos realizados y el importe de cada pedido, puede calcular el número total de pedidos que aparecen en el informe (un recuento total general). Vea Función Sum (campo), más adelante en este mismo capítulo.

· Si divide los pedidos en grupos (por ejemplo, los pedidos agrupados según el estado desde el que se realizaron), puede calcular el número de pedidos por grupo (en este caso, por estado). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo.

· Si divide los pedidos en función de la fecha o de valores Booleanos (por ejemplo, pedidos agrupados por el mes en que se realizaron) puede calcular el número de pedidos de cada grupo en función de la variación del campo fecha o Booleano (en este caso, por el mes). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo.

· Si especifica un conjunto de valores individuales, puede calcular el número de valores del conjunto. Vea Función Sum (x), más adelante en este mismo capítulo.

Date (año, mes, día) Argumentos · año es un número entero que representa un año, por ejemplo 1996.· mes es número entero que representa un mes, por ejemplo 12 representa Diciembre.· día es un número entero que representa el día del mes, por ejemplo 05.

Valores que devuelve Valor de fecha

Acción

Date devuelve un valor de fecha basándose en los elementos individuales de fecha proporcionados: año, mes y día. En el caso de disponer de los elementos individuales de la fecha:· El año debe estar formado por cuatro dígitos.· El mes debe ser un número entre 1 y 12.· El día debe ser un número entre 1 y 31.

Day (x) Argumentos x es un valor de fecha o un valor de fecha y hora.

Valores que devuelve Número entero (el día del mes)Acción

Day extrae el día de un valor de fecha o fecha y hora y devuelve un número entero.

Page 5: FUNCIONES CRYSTAL REPORT

DayOfWeek (x) Argumentos x es un valor de fecha o un valor de fecha-hora.Valores que devuelve Número enteroAcción

DayOfWeek extrae el componente día de una fecha, determina el día de la semana en el que cae y convierte el día de la semana en un número (de 1 a 7). El domingo es el primer día de la semana.

DistinctCount (campo)DistinctCount (campo, campocond)DistinctCount (campo, campocond, cond)DistinctCount (x) Acción

Crystal Reports le permite contar el número de valores distintos que aparecen en un informe. Por ejemplo:

· Si un informe de ventas incluye todos los pedidos realizados por los clientes, puede calcular el número total de clientes distintos que figuran en el informe (un recuento total de valores distintos), excluyendo los valores duplicados. Si un cliente realizó más de un pedido, se pasan por alto las ocurrencias duplicadas de ese cliente. Vea Función Sum (campo), más adelante en este mismo capítulo.

· Si divide los pedidos en grupos (por ejemplo, pedidos agrupados según el estado desde el que se realizaron), puede calcular el número de clientes distintos de cada grupo (en este caso, por estado). Cualquier cliente que realizó más de un pedido y aparece más de una vez en un grupo sólo se cuenta una vez. Vea Función Sum (campo, campocond), más adelante en este mismo capítulo.

· Si divide los pedidos en función de la fecha o de valores Booleanos (por ejemplo, pedidos agrupados por el mes en que se realizaron) puede calcular el número de clientes distintos de cada grupo en función de la variación del campo de fecha o Booleano (en este caso, por el número de clientes que realizaron pedidos cada mes). Si un cliente realizó más de un pedido durante el mes, las instancias duplicadas del cliente se pasan por alto. Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo.

· Si especifica un conjunto de valores individuales, puede calcular el número de valores distintos del conjunto. Los valores duplicados del conjunto sólo se cuentan una vez. Vea Función Sum (x), más adelante en este mismo capítulo.

GroupNumber Valores que devuelve Número entero

Acción Devuelve el número de grupo actual.IsNull (campo) Argumentos

Page 6: FUNCIONES CRYSTAL REPORT

campo es cualquier campo válido de base de datos.

Valores que devuelve Valor booleanoAcción

Evalúa el campo especificado en el registro actual y devuelve TRUE si el campo contiene un valor nulo.

Last4WeeksToSun Valores que devuelve Ninguno

Acción

Especifica un intervalo de fechas que incluye las cuatro últimas semanas anteriores al domingo pasado. La semana comienza en lunes y acaba en domingo. Por ejemplo, Septiembre 1996 empieza en domingo.

· Si hoy es 22 de septiembre (domingo), Last4WeeksToSun empieza el 26 de agosto (lunes) y finaliza el 22 de septiembre (hoy, domingo).· Si hoy es 28 de septiembre (sábado), Last4WeeksToSun comienza el 26 de agosto (lunes) y finaliza el 22 de septiembre (el domingo anterior).

Last7Days Valores que devuelve Ninguno

Acción Especifica un intervalo de valores que incluye todas las fechas desde hace siete días hasta hoy (incluyendo hoy).

LastFullMonth Valores que devuelve Ninguno

Acción Especifica un intervalo de valores de fecha que incluye todas las fechas desde el primer hasta el último día del mes anterior.

LastFullWeek Valores que devuelve Ninguno

Acción Especifica un intervalo de valores de fecha que incluye todas las fechas desde el domingo hasta el sábado de la semana anterior.LastYearMTD Valores que devuelve

Ninguno

Page 7: FUNCIONES CRYSTAL REPORT

Acción Especifica un intervalo de valores de fecha del año anterior que comprende el periodo del mes actual hasta la fecha.LastYearYTD Valores que devuelve

Ninguno

Acción Especifica un intervalo de valores de fecha que incluye todas las fechas del año pasado, hasta la fecha actual del año anterior.Length(x) Argumentos

x es una cadena de texto o campo que contiene una cadena de texto.

Valores que devuelve Número enteroAcción

Length devuelve el número de caracteres contenido en la cadena de texto especificada.

NotaCrystal Reports incluye todos los espacios en blanco como parte de la cuenta de caracteres.NotaLas cadenas de texto deben estar delimitadas por comillas dobles ("") o simples (´ ´).

LowerCase(x) Argumentos x es una cadena de texto cuyos caracteres se van a convertir a minúsculas.

Valores que devuelve Cadena de textoAcción

LowerCase imprime la cadena de texto o el valor de la cadena de texto del campo de datos, con todas las letras en minúsculas.

Maximum (campo)Maximum (campo, campocond)Maximum (campo, campocond, cond)Maximum (x) Acción

Crystal Reports le permite encontrar el valor máximo que aparece en un conjunto de valores. Por ejemplo:

· Si un informe de ventas incluye un campo que muestra el importe de cada pedido, puede encontrar el mayor importe de pedido entre todos los pedidos que aparecen en el informe (el máximo importe total). Vea Función Sum (campo), más adelante en este mismo capítulo.· Si divide los pedidos en grupos (por ejemplo, pedidos agrupados por el estado

Page 8: FUNCIONES CRYSTAL REPORT

desde el que se realizaron) puede encontrar el mayor importe de pedido de cada grupo (en este caso, por estado). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo.· Si divide los pedidos en función de la fecha o de valores Booleanos (por ejemplo, pedidos agrupados por el mes en que se realizaron), puede encontrar el mayor importe de pedido de cada grupo en función de la variación del campo fecha o Booleano (en este caso, por meses) Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo.· Si especifica un conjunto de valores individuales, puede encontrar el valor máximo del conjunto. Vea Función Sum (x), más adelante en este mismo capítulo.

Minimum (campo)Minimum (campo, campocond)Minimum (campo, campocond, cond)Minimum (x) Acción

Crystal Reports le permite encontrar el valor mínimo que aparece en un conjunto de valores. Por ejemplo:

· Si un informe de ventas incluye un campo que muestra el importe de cada pedido, puede encontrar el menor importe de pedido entre todos los pedidos que aparecen en el informe (el mínimo importe total). Vea Función Sum (campo), más adelante en este mismo capítulo.· Si divide los pedidos en grupos (por ejemplo, pedidos agrupados por el estado desde el que se realizaron), puede encontrar el menor importe de pedido de cada grupo (en este caso, por estado). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo.· Si divide los pedidos en función de la fecha o de valores Booleanos (por ejemplo, pedidos agrupados por el mes en que se realizaron), puede encontrar el menor importe de pedido de cada grupo en función de la variación del campo fecha o Booleano (en este caso, por mes). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo.· Si especifica un conjunto de valores individuales, puede encontrar el valor mínimo del conjunto. Vea Función Sum (x), más adelante en este mismo capítulo.

Month(x) Argumentos x es un valor de fecha o un valor de fecha-hora.

Valores que devuelve Número enteroAcción

Month extrae el componente mes de un valor de fecha o de fecha-hora y lo convierte a un número.

MonthToDate Valores que devuelve NingunoAcción

Page 9: FUNCIONES CRYSTAL REPORT

Especifica un intervalo de valores de fecha que incluye todas las fechas desde el primer día del mes hasta hoy.

Next(campo) Argumentos campo es cualquier campo de base de datos o de fórmula.Valores que devuelve

Un valor de campo del mismo tipo que el argumento.

Curso de Inglés El Curso de Inglés más Completo Aprenda Inglés en Sólo ¡6 Meses!www.GanandoConIngles.comEnlaces patrocinados

Acción Next(campo) devuelve el valor del campo especificado en el registro siguiente.Next30DaysNext31To60DaysNext61To90DaysNext91To365Days Valores que devuelve Ninguno

Acción Especifica un intervalo de valores de fecha que incluye todas las fechas dentro del periodo especificado a partir de hoy (incluye hoy).

NextIsNull(campo) Argumentos campo es cualquier campo de base de datos o de fórmula.Valores que devuelve

Valor booleano

Acción Evalúa el campo especificado en el siguiente registro y devuelve TRUE si el campo contiene un valor nulo.NumericText(x) Argumentos x es una cadena de texto en la que se va a comprobar si contiene texto numérico.Valores que devuelve

Valor booleano

Acción NumericText comprueba si el contenido de un objeto de texto es un número.

· Si todo el contenido del campo es un número o si los caracteres obtenidos mediante el operador de subíndice son íntegramente un número, la expresión devuelve el valor TRUE.· Si cualquier parte del contenido del campo o de los caracteres obtenidos no es un número, la expresión devuelve el valor FALSE.

Page 10: FUNCIONES CRYSTAL REPORT

Over90Days Valores que devuelve Ninguno

Acción Especifica un intervalo de valores que incluye todos los valores que son 90 días más antiguos que la fecha actual.PageNumber Valores que devuelve Número entero

Acción PageNumber inserta el número de página actual como un campo dentro de una fórmula.

PopulationStdDev (campo)PopulationStdDev (campo, campocond)PopulationStdDev (campo, campocond, cond), PopulationStdDev (x) Acción

Crystal Reports le permite encontrar la desviación estándar de la población de un conjunto de valores del informe. Por ejemplo:

· Puede calcular la desviación estándar total de la población para todos los valores de un campo. Vea Función Sum (campo), más adelante en este mismo capítulo.· Puede calcular la desviación estándar de la población para todos los valores de un grupo (por ejemplo, ventas agrupadas según el estado donde se generaron). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo.· Puede calcular la desviación estándar de la población para todos los valores de un grupo, agrupado según las variaciones de una fecha o un campo Booleano (por ejemplo, ventas agrupadas en función del mes en que se generaron). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo.· Si especifica un conjunto de valores individuales, puede calcular la desviación estándar de la población de los valores de este conjunto. Vea Función Sum (x), más adelante en este mismo capítulo.

PopulationVariance (campo)PopulationVariance (campo, campocond)PopulationVariance (campo, campocond, cond)PopulationVariance (x) Acción

Crystal Reports le permite encontrar la varianza de la población en un conjunto de valores del informe. Por ejemplo:

· Puede calcular la varianza total de la población para todos los valores de un campo. Vea Función Sum (campo), más adelante en este mismo capítulo.· Puede calcular la varianza de la población para todos los valores de un grupo (por ejemplo, ventas agrupadas según el estado que las originaron). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo.· Puede calcular la varianza de la población para todos los valores de un grupo, agrupado según las variaciones de una fecha o un campo Booleano (por ejemplo,

Page 11: FUNCIONES CRYSTAL REPORT

ventas agrupadas en función del mes en que se generaron). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo.· Si especifica un conjunto de valores individuales, puede calcular la varianza de la población de los valores de este conjunto. Vea Función Sum (x), más adelante en este mismo capítulo.

Previous(campo) Argumentos campo es cualquier campo válido de base de datos o de fórmula.

Valores que devuelve Un valor de campo del mismo tipo que el argumento campo.Acción

Previous(campo) devuelve el valor que tiene el campo especificado en el registro anterior.

PreviousIsNull(campo) Argumentos campo es cualquier campo válido de base de datos o de fórmula.Valores que devuelve

Valor booleano

Acción Evalúa el campo especificado en el registro anterior y devuelve TRUE si el campo contiene un valor nulo.PrintDate Valores que devuelve

Valor de fecha

Acción PrintDate inserta la fecha en la que se imprime el informe como un campo dentro de una formula.RecordNumber Valores que devuelve Número entero

Acción RecordNumber devuelve el número de registro actual.

Remainder (num, denom) Argumentos · num es un valor fraccionario.· denom es un valor fraccionario.

Valores que devuelve Valor fraccionario

Acción Remainder devuelve el resto después de dividir el numerador (dividendo) por el denominador (divisor). En una situación de división típica, Crystal Reports expresa

Page 12: FUNCIONES CRYSTAL REPORT

un cociente como un número entero (caso de que exista) y hasta seis posiciones decimales. Sin embargo, al usar Remainder Crystal Reports realiza la división internamente, determina el cociente como un número entero y el resto, y devuelve únicamente el resto.ReplicateString (cad, copias) Argumentos

· cad es la cadena de texto que se va a replicar.· copias es un número entero que indica el número de veces que se ha de replicar cad.

Valores que devuelve Cadena de texto

Acción Replica la cadena de cad las veces que se haya especificado en copias.Round(x)Round(x, lugares) Argumentos · x es un valor fraccionario que se va a redondear.· lugares es un número entero que indica el número de posiciones decimales que va a tener x una vez redondeado.

Valores que devuelve Número fraccionario

Acción Round redondea al número entero más cercano en caso de no especificarse el argumento lugares. Si el valor que hay a la derecha del punto de decimal es .499 o menor, Crystal Reports redondea hacia el siguiente número inferior. Si el valor que hay a la derecha del punto decimal es .5 o superior, Crystal Reports redondea hacia el siguiente número superior.

Si se usa el argumento lugares, el valor de x se redondea hacia la posición decimal más cercana indicada en lugares. Especificar lugares como 0 tiene el mismo efecto que no incluir este argumento. Si lugares es negativo, el número se redondea hacia la decena, centena, etc. más cercana.

StdDev (campo)StdDev (campo, campocond)StdDev (campo, campocond, cond)StdDev (x) Acción

Crystal Reports le permite encontrar la desviación estándar de un conjunto de valores del informe. Por ejemplo:

· Puede calcular la desviación estándar total para todos los valores de un campo. Vea Función Sum (campo), más adelante en este mismo capítulo.· Puede calcular la desviación estándar para todos los valores de un grupo (por

Page 13: FUNCIONES CRYSTAL REPORT

ejemplo, ventas agrupadas según el estado en que se originaron). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo.· Puede calcular la desviación estándar para todos los valores de un grupo, agrupado según las variaciones de una fecha o un campo Booleano (por ejemplo, ventas agrupadas en función del mes en que se generaron). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo.· Si especifica un conjunto de valores individuales, puede calcular la desviación estándar de los valores del conjunto. Vea Función Sum (x), más adelante en este mismo capítulo.

Sum (campo)Sum (campo, campocond)Sum (campo, campocond, cond)Sum (x) Acción

Crystal Reports le permite sumar los valores que aparecen en el informe. Por ejemplo:

· Si un informe de ventas incluye un campo que muestra el importe de cada pedido, puede calcular la suma de todos los pedidos que aparecen en el informe (suma total general). Vea Función Sum (campo), más adelante en este mismo capítulo.· Si divide los pedidos en grupos (por ejemplo, los pedidos agrupados según el estado desde el que se originaron), puede calcular la suma de los importes de los pedidos de cada grupo (en este caso, por estado). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo· Si divide los pedidos en grupos de fecha o Booleanos (por ejemplo, pedidos agrupados según el mes en que se realizaron), puede calcular la suma de los importes de los pedidos de cada grupo teniendo como referencia las variaciones de una fecha o un campo Booleano (en este caso, por mes). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo.

· Si especifica un conjunto de valores individuales, también puede calcular la suma de los valores del conjunto. Vea Función Sum (x), más adelante en este mismo capítulo.

Función Sum (campo) Argumentos campo es cualquier campo válido de base de datos o de fórmula que la función puede evaluar.

Valores que devuelve Número fraccionario

Acción La función Sum (campo) resume los valores del campo especificado a lo largo de todo el informe. Genera un resumen de "total general".

Page 14: FUNCIONES CRYSTAL REPORT

Función Sum (campo, campocond) Argumentos · campo es cualquier campo válido de base de datos o de fórmula que la función puede evaluar.· campocond es cualquier campo válido de base de datos o de fórmula usado para agrupar los valores por campo.

Valores que devuelve Número fraccionario

Acción La función Sum (campo, campocond) resume cada grupo de valores que se genera cuando se cumple la condición de resumen especificadaFunción Sum (campo, campocond, cond) Argumentos · campo es cualquier campo válido de base de datos o de fórmula que la función puede evaluar.· campocond es cualquier campo de fecha o booleano válido usado para agrupar los valores por campo.· cond es una cadena de texto que indica la condición de campocond que controla el agrupamiento. Las cadenas válidas para este argumento dependen de si campocond contiene valores de fecha o booleanos.

Valores que devuelve Número fraccionario

Acción La función Sum (campo, campocond, cond) resume cada grupo de valores que se genera cuando se cumple la condición especificada de resumen. Estas funciones operan igual que Sum (campo, campocond) pero, como usan un campo de fecha o booleano para ordenar y agrupar por campo (desencadenante), necesitan una condición adicional.Función Sum (x) Argumentos x es una matriz de valores que puede evaluar la función usada.Valores que devuelve Número fraccionarioAcción

Sum(x) resume los valores de una matriz de constantes, los valores de un campo de datos o las fórmulas (a*b, c/d, etc.) separados por comas.

Today Valores que devuelve Valor de fecha

Acción Today devuelve la fecha actual.

ToNumber(x) Argumentos x es una cadena de texto que contiene texto numérico.Valores que devuelve Número fraccionario

Page 15: FUNCIONES CRYSTAL REPORT

Acción ToNumber convierte una cadena de texto en un número.

En una base de datos, algunos números se almacenan en campos numéricos, como números, y otros se almacenan en campos de tipo cadena, como texto. Cuando crea la base de datos determina cuáles son los campos que van a ser numéricos y cuáles van a ser de texto. Los números sobre los que puede querer realizar cálculos (precio del producto, cantidad pedida, etc.) generalmente se almacenan en campos numéricos; los números sobre los que en principio no se espera realizar cálculos (número de cliente, número de teléfono, etc.) generalmente se almacenan como objetos de texto.

ToNumber le permite convertir un número almacenado como texto en un número con el que puede realizar operaciones aritméticas.

ToText (x)ToText (x, lugares) Argumentos · x es un número que desea convertir en una cadena de texto.· lugares es un número entero que indica el número de posiciones decimales de x que se han de tener en cuenta.

Valores que devuelve Cadena de texto

Acción La función ToText convierte un número en una cadena de texto.ToWords (x)ToWords (x, lugares) Argumentos

· x es un número fraccionario que se va a convertir en palabras.· lugares es un número entero que indica el número de posiciones decimales que se van a convertir. (Este argumento es opcional.)

Valores que devuelve Cadena de texto

Acción Puede usar esta función para convertir en palabras el valor de un campo de número o moneda o el resultado de un cálculo numérico, de forma que se pueda usar como texto. La posibilidad de ajustar el número de posiciones decimales puede ser útil cuando el número es el resultado de un cálculo que puede producir más posiciones decimales que las deseadas.TrimLeft (x) Argumentos x es una cadena de texto justificada a la derecha.Valores que devuelve Cadena de texto

Page 16: FUNCIONES CRYSTAL REPORT

Acción TrimLeft elimina todos los espacios que hay a la izquierda de una cadena o un campo de datos que está almacenado con justificación a la derecha en una base de datos.

TrimRight (x) Argumentos x es una cadena de texto justificada a la izquierda.Valores que devuelve Cadena de texto

Acción TrimRight elimina todos los espacios que hay a la derecha de una cadena o un campo de datos que está almacenado con justificación a la izquierda en una base de datos..

Truncate (x) Argumentos x es un número fraccionario que se va a truncar.Valores que devuelve

Número fraccionario

Acción Truncate(x) devuelve un valor entero truncando el número desde el punto decimal.UpperCase (x) Argumentos

x es una cadena de texto.

Valores que devuelve Cadena de texto

Acción UpperCase imprime en mayúsculas la cadena de texto o el valor de texto del campo de datos.

Variance (campo)Variance (campo, campocond)Variance (campo, campocond, cond)Variance (x) Acción

Crystal Reports le permite encontrar la varianza de un conjunto de valores del informe. Por ejemplo:

· Puede calcular la varianza total para todos los valores de un campo. Vea Función Sum (campo), más adelante en este mismo capítulo.

· Puede calcular la varianza para todos los valores de un grupo (por ejemplo, ventas agrupadas según el estado que las originaron). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo.

Page 17: FUNCIONES CRYSTAL REPORT

· Puede calcular la varianza para todos los valores de un grupo, agrupado según las variaciones de una fecha o un campo Booleano (por ejemplo, ventas agrupadas en función del mes en que se generaron). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo.

· Si especifica un conjunto de valores individuales, puede calcular la varianza de los valores del conjunto. Vea Función Sum (x), más adelante en este mismo capítulo.

WeekToDateFromSun Valores que devuelve Ninguno

Acción Especifica un intervalo de valores de fecha que incluye todos los días desde el último domingo hasta hoy (incluyendo hoy).

WhilePrintingRecords Valores que devuelve Ninguno

Acción Fuerza al programa a evaluar la fórmula mientras imprime datos de los registros de la base de datos.WhileReadingRecords Valores que devuelve Ninguno

Acción Fuerza al programa a evaluar la fórmula mientras lee datos de los registros de la base de datos.

Year(x) Argumentos x es un valor de fecha o un valor de fecha y hora.

Valores que devuelve Número entero

Acción Year extrae el año de una fecha y lo devuelve como un número.YearToDate Valores que devuelve Ninguno

Acción Especifica un intervalo de valores de fecha que incluye todos los días desde el primer día del año hasta la fecha.