4-funciones crystal report

39
Crystal Reports para Visual Basic Introducción Este capítulo trata en profundidad todas las funciones de Crystal Reports. 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. CAPÍTULO 4 Funciones

Transcript of 4-funciones crystal report

Page 1: 4-funciones crystal report

Crystal Reports para Visual Basic

IntroducciónEste capítulo trata en profundidad todas las funciones de Crystal Reports.

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)Argumentosx es cualquier número.

Valores que devuelveValor absoluto de x.

AcciónAbs devuelve el valor absoluto de x, eliminando cualquier valor negativo.

C A P Í T U L O 4

Funciones

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 2: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

Aged0To30DaysAged31To60DaysAged61To90Days

Valores que devuelve Ninguno

AcciónEspecifica 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.

AllDatesFromTodayValores que devuelve Ninguno

AcciónEspecifica 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.

AllDatesFromTomorrowValores que devuelve Ninguno

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

AllDatesToTodayValores que devuelve Ninguno

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 34 of 27 Printed: 09/30/96 12:42 PM

Page 3: 4-funciones crystal report

Crystal Reports para Visual Basic

AcciónEspecifica 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ónEspecifica 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ónCrystal 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.

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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 4: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

BeforeReadingRecordsValores 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ónEspecifica 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 Ninguno

AcciónEspecifica 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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 36 of 27 Printed: 09/30/96 12:42 PM

Page 5: 4-funciones crystal report

Crystal Reports para Visual Basic

Count (campo)Count (campo, campocond)Count (campo, campocond, cond)Count (x)

AcciónCrystal Reports le permite contar los valores que aparecen en el informe. Por ejemplo:

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

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 6: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

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)Argumentosx es un valor de fecha o un valor de fecha y hora.

Valores que devuelveNúmero entero (el día del mes)

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

DayOfWeek (x) Argumentosx es un valor de fecha o un valor de fecha-hora.

Valores que devuelveNúmero entero

Acció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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 38 of 27 Printed: 09/30/96 12:42 PM

Page 7: 4-funciones crystal report

Crystal Reports para Visual Basic

DistinctCount (campo)DistinctCount (campo, campocond)DistinctCount (campo, campocond, cond)DistinctCount (x)

AcciónCrystal 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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 8: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

GroupNumberValores que devuelve Número entero

AcciónDevuelve el número de grupo actual.

IsNull (campo) Argumentoscampo es cualquier campo válido de base de datos.

Valores que devuelve Valor booleano

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

Last4WeeksToSunValores que devuelveNinguno

AcciónEspecifica 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).

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 40 of 27 Printed: 09/30/96 12:42 PM

Page 9: 4-funciones crystal report

Crystal Reports para Visual Basic

Last7DaysValores que devuelveNinguno

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

LastFullMonth Valores que devuelve Ninguno

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

LastFullWeekValores que devuelveNinguno

AcciónEspecifica 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 devuelveNinguno

AcciónEspecifica un intervalo de valores de fecha del año anterior que comprende el periodo del mes actual hasta la fecha.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 10: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

LastYearYTD Valores que devuelve Ninguno

AcciónEspecifica 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)Argumentosx es una cadena de texto o campo que contiene una cadena de texto.

Valores que devuelveNúmero entero

AcciónLength devuelve el número de caracteres contenido en la cadena de texto especificada.

Nota Crystal Reports incluye todos los espacios en blanco como parte de la cuenta de caracteres.

Nota Las cadenas de texto deben estar delimitadas por comillas dobles ("") o simples (’ ’).

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

Valores que devuelve Cadena de texto

Acció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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 42 of 27 Printed: 09/30/96 12:42 PM

Page 11: 4-funciones crystal report

Crystal Reports para Visual Basic

Maximum (campo)Maximum (campo, campocond)Maximum (campo, campocond, cond)Maximum (x)

AcciónCrystal 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 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ónCrystal Reports le permite encontrar el valor mínimo que aparece en un conjunto de valores. Por ejemplo:

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 12: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

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) Argumentosx es un valor de fecha o un valor de fecha-hora.

Valores que devuelveNúmero entero

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

MonthToDateValores que devuelve Ninguno

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

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 44 of 27 Printed: 09/30/96 12:42 PM

Page 13: 4-funciones crystal report

Crystal Reports para Visual Basic

Next(campo) Argumentoscampo es cualquier campo de base de datos o de fórmula.

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

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

Next30DaysNext31To60DaysNext61To90DaysNext91To365Days

Valores que devuelve Ninguno

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

NextIsNull(campo)Argumentoscampo 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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 14: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

NumericText(x)Argumentosx 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.

Over90Days Valores que devuelve Ninguno

AcciónEspecifica un intervalo de valores que incluye todos los valores que son 90 días más antiguos que la fecha actual.

PageNumberValores que devuelve Número entero

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

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 46 of 27 Printed: 09/30/96 12:42 PM

Page 15: 4-funciones crystal report

Crystal Reports para Visual Basic

PopulationStdDev (campo)PopulationStdDev (campo, campocond)PopulationStdDev (campo, campocond, cond), PopulationStdDev (x)

AcciónCrystal 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ónCrystal Reports le permite encontrar la varianza de la población en un conjunto de valores del informe. Por ejemplo:

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 16: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

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, 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)Argumentoscampo 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) Argumentoscampo 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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 48 of 27 Printed: 09/30/96 12:42 PM

Page 17: 4-funciones crystal report

Crystal Reports para Visual Basic

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.

RecordNumberValores 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 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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 18: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 50 of 27 Printed: 09/30/96 12:42 PM

Page 19: 4-funciones crystal report

Crystal Reports para Visual Basic

StdDev (campo)StdDev (campo, campocond)StdDev (campo, campocond, cond)StdDev (x)

AcciónCrystal 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 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ónCrystal 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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 20: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

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)Argumentoscampo 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".

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 especificada

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 52 of 27 Printed: 09/30/96 12:42 PM

Page 21: 4-funciones crystal report

Crystal Reports para Visual Basic

Funció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) Argumentosx es una matriz de valores que puede evaluar la función usada.

Valores que devuelve Número fraccionario

Acció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.

TodayValores que devuelveValor de fecha

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 22: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

AcciónToday devuelve la fecha actual.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 54 of 27 Printed: 09/30/96 12:42 PM

Page 23: 4-funciones crystal report

Crystal Reports para Visual Basic

ToNumber(x) Argumentosx es una cadena de texto que contiene texto numérico.

Valores que devuelve Número fraccionario

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ónLa función ToText convierte un número en una cadena de texto.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 24: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

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)Argumentosx es una cadena de texto justificada a la derecha.

Valores que devuelve Cadena de texto

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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 56 of 27 Printed: 09/30/96 12:42 PM

Page 25: 4-funciones crystal report

Crystal Reports para Visual Basic

TrimRight (x)Argumentosx 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)Argumentosx 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) Argumentosx 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.

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Page 26: 4-funciones crystal report

Crystal Reports para Visual Basic

Capítulo 4 Funciones

Variance (campo)Variance (campo, campocond)Variance (campo, campocond, cond)Variance (x)

AcciónCrystal 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.

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ónEspecifica un intervalo de valores de fecha que incluye todos los días desde el último domingo hasta hoy (incluyendo hoy).

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen

Revision #: 2 Page: 58 of 27 Printed: 09/30/96 12:42 PM

Page 27: 4-funciones crystal report

Crystal Reports para Visual Basic

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)Argumentosx es un valor de fecha o un valor de fecha y hora.

Valores que devuelve Número entero

AcciónYear extrae el año de una fecha y lo devuelve como un número.

YearToDateValores que devuelve Ninguno

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

Filename: document.docx Project: CHAPTER 0

Template: Author: AM Last Saved By: Carmen