Вы находитесь на странице: 1из 26

C A P T U L O

Funciones

Introduccin
Este captulo 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 funcin, Crystal Reports realiza el conjunto de operaciones que integran la funcin sin tener que especificar cada operacin por separado. De esta forma, una funcin es una especie de abreviatura que le permite crear frmulas de una manera ms rpida y sencilla. Se incluyen ejemplos sencillos de cada funcin. Adems, se incluyen referencias de muchas de las funciones a las frmulas del tema Frmulas en accin de la Ayuda en pantalla de Crystal Reports (busque Frmulas en accin). Frmulas en accin muestra usos avanzados de las funciones para resolver problemas complejos de la vida real.

Abs (x)
Argumentos
x es cualquier nmero.

Valores que devuelve


Valor absoluto de x.

Accin
Abs devuelve el valor absoluto de x, eliminando cualquier valor negativo.

Crystal Reports para Visual Basic 33

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 33 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

Aged0To30Days Aged31To60Days Aged61To90Days


Valores que devuelve
Ninguno

Accin
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
Ninguno

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

AllDatesFromTomorrow
Valores que devuelve
Ninguno

Accin
Especifica un intervalo de valores de fecha desde el da actual. AllDatesFromTomorrow no incluye el da actual, pero s incluye cualquier fecha futura.

AllDatesToToday
Valores que devuelve
Ninguno

34 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 34 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

Accin
Especifica un intervalo de valores de fecha que incluye todos los das anteriores al da actual. AllDatesToToday incluye el da actual.

AllDatesToYesterday
Valores que devuelve
Ninguno

Accin
Especifica un intervalo de valores de fecha que incluye todos los das anteriores hasta el da anterior al da actual. AllDatesToYesterday incluye todas las fechas anteriores al da de hoy, pero no incluye el da actual.

Average (campo) Average (campo, campocond) Average (campo, campocond, cond) Average (x)
Accin
Crystal Reports le permite calcular el promedio de los valores que aparecen en el informe. Por ejemplo: y 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 Funcin Sum (campo), ms adelante en este mismo captulo. y Si divide los pedidos en grupos (por ejemplo, pedidos agrupados segn el estado desde el que se realizaron), puede calcular el pedido promedio por grupo (en este caso, por estado). Vea Funcin Sum (campo, campocond), ms adelante en este mismo captulo. y Si divide los pedidos en funcin 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 funcin de la variacin del campo de fecha o Booleano (en este caso, por mes). Vea Funcin Sum (campo, campocond, cond), ms adelante en este mismo captulo. y Si especifica una matriz de valores individuales, tambin puede calcular el valor promedio del conjunto. Vea Funcin Sum (x), ms adelante en este mismo captulo.

Crystal Reports para Visual Basic 35

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 35 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

BeforeReadingRecords
Valores que devuelve
Ninguno

Accin
Especifica que la frmula se va a evaluar antes de leer los registros de la base de datos.

Calendar1stHalf Calendar2ndHalf
Valores que devuelve
Ninguno

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

Calendar1stQtr Calendar2ndQtr, Calendar3rdQtr Calendar4thQtr


Valores que devuelve
Ninguno

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

36 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 36 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

Count (campo) Count (campo, campocond) Count (campo, campocond, cond) Count (x)
Accin
Crystal Reports le permite contar los valores que aparecen en el informe. Por ejemplo: y Si un informe de ventas incluye todos los pedidos realizados y el importe de cada pedido, puede calcular el nmero total de pedidos que aparecen en el informe (un recuento total general). Vea Funcin Sum (campo), ms adelante en este mismo captulo. y Si divide los pedidos en grupos (por ejemplo, los pedidos agrupados segn el estado desde el que se realizaron), puede calcular el nmero de pedidos por grupo (en este caso, por estado). Vea Funcin Sum (campo, campocond), ms adelante en este mismo captulo. y Si divide los pedidos en funcin de la fecha o de valores Booleanos (por ejemplo, pedidos agrupados por el mes en que se realizaron) puede calcular el nmero de pedidos de cada grupo en funcin de la variacin del campo fecha o Booleano (en este caso, por el mes). Vea Funcin Sum (campo, campocond, cond), ms adelante en este mismo captulo. y Si especifica un conjunto de valores individuales, puede calcular el nmero de valores del conjunto. Vea Funcin Sum (x), ms adelante en este mismo captulo.

Date (ao, mes, da)


Argumentos
y ao es un nmero entero que representa un ao, por ejemplo 1996. y mes es nmero entero que representa un mes, por ejemplo 12 representa Diciembre. y da es un nmero entero que representa el da del mes, por ejemplo 05.

Valores que devuelve


Valor de fecha

Crystal Reports para Visual Basic 37

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 37 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

Accin
Date devuelve un valor de fecha basndose en los elementos individuales de fecha proporcionados: ao, mes y da. En el caso de disponer de los elementos individuales de la fecha: y El ao debe estar formado por cuatro dgitos. y El mes debe ser un nmero entre 1 y 12. y El da debe ser un nmero entre 1 y 31.

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

Valores que devuelve


Nmero entero (el da del mes)

Accin
Day extrae el da de un valor de fecha o fecha y hora y devuelve un nmero entero.

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

Valores que devuelve


Nmero entero

Accin
DayOfWeek extrae el componente da de una fecha, determina el da de la semana en el que cae y convierte el da de la semana en un nmero (de 1 a 7). El domingo es el primer da de la semana.

38 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 38 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

DistinctCount (campo) DistinctCount (campo, campocond) DistinctCount (campo, campocond, cond) DistinctCount (x)
Accin
Crystal Reports le permite contar el nmero de valores distintos que aparecen en un informe. Por ejemplo: y Si un informe de ventas incluye todos los pedidos realizados por los clientes, puede calcular el nmero total de clientes distintos que figuran en el informe (un recuento total de valores distintos), excluyendo los valores duplicados. Si un cliente realiz ms de un pedido, se pasan por alto las ocurrencias duplicadas de ese cliente. Vea Funcin Sum (campo), ms adelante en este mismo captulo. y Si divide los pedidos en grupos (por ejemplo, pedidos agrupados segn el estado desde el que se realizaron), puede calcular el nmero de clientes distintos de cada grupo (en este caso, por estado). Cualquier cliente que realiz ms de un pedido y aparece ms de una vez en un grupo slo se cuenta una vez. Vea Funcin Sum (campo, campocond), ms adelante en este mismo captulo. y Si divide los pedidos en funcin de la fecha o de valores Booleanos (por ejemplo, pedidos agrupados por el mes en que se realizaron) puede calcular el nmero de clientes distintos de cada grupo en funcin de la variacin del campo de fecha o Booleano (en este caso, por el nmero de clientes que realizaron pedidos cada mes). Si un cliente realiz ms de un pedido durante el mes, las instancias duplicadas del cliente se pasan por alto. Vea Funcin Sum (campo, campocond, cond), ms adelante en este mismo captulo. y Si especifica un conjunto de valores individuales, puede calcular el nmero de valores distintos del conjunto. Los valores duplicados del conjunto slo se cuentan una vez. Vea Funcin Sum (x), ms adelante en este mismo captulo.

Crystal Reports para Visual Basic 39

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 39 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

GroupNumber
Valores que devuelve
Nmero entero

Accin
Devuelve el nmero de grupo actual.

IsNull (campo)
Argumentos
campo es cualquier campo vlido de base de datos.

Valores que devuelve


Valor booleano

Accin
Evala el campo especificado en el registro actual y devuelve TRUE si el campo contiene un valor nulo.

Last4WeeksToSun
Valores que devuelve
Ninguno

Accin
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. y Si hoy es 22 de septiembre (domingo), Last4WeeksToSun empieza el 26 de agosto (lunes) y finaliza el 22 de septiembre (hoy, domingo). y Si hoy es 28 de septiembre (sbado), Last4WeeksToSun comienza el 26 de agosto (lunes) y finaliza el 22 de septiembre (el domingo anterior).

40 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 40 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

Last7Days
Valores que devuelve
Ninguno

Accin
Especifica un intervalo de valores que incluye todas las fechas desde hace siete das hasta hoy (incluyendo hoy).

LastFullMonth
Valores que devuelve
Ninguno

Accin
Especifica un intervalo de valores de fecha que incluye todas las fechas desde el primer hasta el ltimo da del mes anterior.

LastFullWeek
Valores que devuelve
Ninguno

Accin
Especifica un intervalo de valores de fecha que incluye todas las fechas desde el domingo hasta el sbado de la semana anterior.

LastYearMTD
Valores que devuelve
Ninguno

Accin
Especifica un intervalo de valores de fecha del ao anterior que comprende el periodo del mes actual hasta la fecha.

Crystal Reports para Visual Basic 41

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 41 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

LastYearYTD
Valores que devuelve
Ninguno

Accin
Especifica un intervalo de valores de fecha que incluye todas las fechas del ao pasado, hasta la fecha actual del ao anterior.

Length(x)
Argumentos
x es una cadena de texto o campo que contiene una cadena de texto.

Valores que devuelve


Nmero entero

Accin
Length devuelve el nmero 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)
Argumentos
x es una cadena de texto cuyos caracteres se van a convertir a minsculas.

Valores que devuelve


Cadena de texto

Accin
LowerCase imprime la cadena de texto o el valor de la cadena de texto del campo de datos, con todas las letras en minsculas.

42 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 42 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

Maximum (campo) Maximum (campo, campocond) Maximum (campo, campocond, cond) Maximum (x)
Accin
Crystal Reports le permite encontrar el valor mximo que aparece en un conjunto de valores. Por ejemplo: y 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 mximo importe total). Vea Funcin Sum (campo), ms adelante en este mismo captulo. y 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 Funcin Sum (campo, campocond), ms adelante en este mismo captulo. y Si divide los pedidos en funcin 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 funcin de la variacin del campo fecha o Booleano (en este caso, por meses) Vea Funcin Sum (campo, campocond, cond), ms adelante en este mismo captulo. y Si especifica un conjunto de valores individuales, puede encontrar el valor mximo del conjunto. Vea Funcin Sum (x), ms adelante en este mismo captulo.

Minimum (campo) Minimum (campo, campocond) Minimum (campo, campocond, cond) Minimum (x)
Accin
Crystal Reports le permite encontrar el valor mnimo que aparece en un conjunto de valores. Por ejemplo:

Crystal Reports para Visual Basic 43

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 43 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

y 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 mnimo importe total). Vea Funcin Sum (campo), ms adelante en este mismo captulo. y 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 Funcin Sum (campo, campocond), ms adelante en este mismo captulo. y Si divide los pedidos en funcin 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 funcin de la variacin del campo fecha o Booleano (en este caso, por mes). Vea Funcin Sum (campo, campocond, cond), ms adelante en este mismo captulo. y Si especifica un conjunto de valores individuales, puede encontrar el valor mnimo del conjunto. Vea Funcin Sum (x), ms adelante en este mismo captulo.

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

Valores que devuelve


Nmero entero

Accin
Month extrae el componente mes de un valor de fecha o de fecha-hora y lo convierte a un nmero.

MonthToDate
Valores que devuelve
Ninguno

Accin
Especifica un intervalo de valores de fecha que incluye todas las fechas desde el primer da del mes hasta hoy.

44 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 44 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

Next(campo)
Argumentos
campo es cualquier campo de base de datos o de frmula.

Valores que devuelve


Un valor de campo del mismo tipo que el argumento.

Accin
Next(campo) devuelve el valor del campo especificado en el registro siguiente.

Next30Days Next31To60Days Next61To90Days Next91To365Days


Valores que devuelve
Ninguno

Accin
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 frmula.

Valores que devuelve


Valor booleano

Accin
Evala el campo especificado en el siguiente registro y devuelve TRUE si el campo contiene un valor nulo.

Crystal Reports para Visual Basic 45

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 45 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

NumericText(x)
Argumentos
x es una cadena de texto en la que se va a comprobar si contiene texto numrico.

Valores que devuelve


Valor booleano

Accin
NumericText comprueba si el contenido de un objeto de texto es un nmero. y Si todo el contenido del campo es un nmero o si los caracteres obtenidos mediante el operador de subndice son ntegramente un nmero, la expresin devuelve el valor TRUE. y Si cualquier parte del contenido del campo o de los caracteres obtenidos no es un nmero, la expresin devuelve el valor FALSE.

Over90Days
Valores que devuelve
Ninguno

Accin
Especifica un intervalo de valores que incluye todos los valores que son 90 das ms antiguos que la fecha actual.

PageNumber
Valores que devuelve
Nmero entero

Accin
PageNumber inserta el nmero de pgina actual como un campo dentro de una frmula.

46 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 46 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

PopulationStdDev (campo) PopulationStdDev (campo, campocond) PopulationStdDev (campo, campocond, cond), PopulationStdDev (x)
Accin
Crystal Reports le permite encontrar la desviacin estndar de la poblacin de un conjunto de valores del informe. Por ejemplo: y Puede calcular la desviacin estndar total de la poblacin para todos los valores de un campo. Vea Funcin Sum (campo), ms adelante en este mismo captulo. y Puede calcular la desviacin estndar de la poblacin para todos los valores de un grupo (por ejemplo, ventas agrupadas segn el estado donde se generaron). Vea Funcin Sum (campo, campocond), ms adelante en este mismo captulo. y Puede calcular la desviacin estndar de la poblacin para todos los valores de un grupo, agrupado segn las variaciones de una fecha o un campo Booleano (por ejemplo, ventas agrupadas en funcin del mes en que se generaron). Vea Funcin Sum (campo, campocond, cond), ms adelante en este mismo captulo. y Si especifica un conjunto de valores individuales, puede calcular la desviacin estndar de la poblacin de los valores de este conjunto. Vea Funcin Sum (x), ms adelante en este mismo captulo.

PopulationVariance (campo) PopulationVariance (campo, campocond) PopulationVariance (campo, campocond, cond) PopulationVariance (x)
Accin
Crystal Reports le permite encontrar la varianza de la poblacin en un conjunto de valores del informe. Por ejemplo:

Crystal Reports para Visual Basic 47

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 47 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

y Puede calcular la varianza total de la poblacin para todos los valores de un campo. Vea Funcin Sum (campo), ms adelante en este mismo captulo. y Puede calcular la varianza de la poblacin para todos los valores de un grupo (por ejemplo, ventas agrupadas segn el estado que las originaron). Vea Funcin Sum (campo, campocond), ms adelante en este mismo captulo. y Puede calcular la varianza de la poblacin para todos los valores de un grupo, agrupado segn las variaciones de una fecha o un campo Booleano (por ejemplo, ventas agrupadas en funcin del mes en que se generaron). Vea Funcin Sum (campo, campocond, cond), ms adelante en este mismo captulo. y Si especifica un conjunto de valores individuales, puede calcular la varianza de la poblacin de los valores de este conjunto. Vea Funcin Sum (x), ms adelante en este mismo captulo.

Previous(campo)
Argumentos
campo es cualquier campo vlido de base de datos o de frmula.

Valores que devuelve


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

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

PreviousIsNull(campo)
Argumentos
campo es cualquier campo vlido de base de datos o de frmula.

Valores que devuelve


Valor booleano

Accin
Evala el campo especificado en el registro anterior y devuelve TRUE si el campo contiene un valor nulo.

48 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 48 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

PrintDate
Valores que devuelve
Valor de fecha

Accin
PrintDate inserta la fecha en la que se imprime el informe como un campo dentro de una formula.

RecordNumber
Valores que devuelve
Nmero entero

Accin
RecordNumber devuelve el nmero de registro actual.

Remainder (num, denom)


Argumentos
y num es un valor fraccionario. y denom es un valor fraccionario.

Valores que devuelve


Valor fraccionario

Accin
Remainder devuelve el resto despus de dividir el numerador (dividendo) por el denominador (divisor). En una situacin de divisin tpica, Crystal Reports expresa un cociente como un nmero entero (caso de que exista) y hasta seis posiciones decimales. Sin embargo, al usar Remainder Crystal Reports realiza la divisin internamente, determina el cociente como un nmero entero y el resto, y devuelve nicamente el resto.

Crystal Reports para Visual Basic 49

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 49 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

ReplicateString (cad, copias)


Argumentos
y cad es la cadena de texto que se va a replicar. y copias es un nmero entero que indica el nmero de veces que se ha de replicar cad.

Valores que devuelve


Cadena de texto

Accin
Replica la cadena de cad las veces que se haya especificado en copias.

Round(x) Round(x, lugares)


Argumentos
y x es un valor fraccionario que se va a redondear. y lugares es un nmero entero que indica el nmero de posiciones decimales que va a tener x una vez redondeado.

Valores que devuelve


Nmero fraccionario

Accin
Round redondea al nmero entero ms 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 nmero inferior. Si el valor que hay a la derecha del punto decimal es .5 o superior, Crystal Reports redondea hacia el siguiente nmero superior. Si se usa el argumento lugares, el valor de x se redondea hacia la posicin decimal ms cercana indicada en lugares. Especificar lugares como 0 tiene el mismo efecto que no incluir este argumento. Si lugares es negativo, el nmero se redondea hacia la decena, centena, etc. ms cercana.

50 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 50 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

StdDev (campo) StdDev (campo, campocond) StdDev (campo, campocond, cond) StdDev (x)
Accin
Crystal Reports le permite encontrar la desviacin estndar de un conjunto de valores del informe. Por ejemplo: y Puede calcular la desviacin estndar total para todos los valores de un campo. Vea Funcin Sum (campo), ms adelante en este mismo captulo. y Puede calcular la desviacin estndar para todos los valores de un grupo (por ejemplo, ventas agrupadas segn el estado en que se originaron). Vea Funcin Sum (campo, campocond), ms adelante en este mismo captulo. y Puede calcular la desviacin estndar para todos los valores de un grupo, agrupado segn las variaciones de una fecha o un campo Booleano (por ejemplo, ventas agrupadas en funcin del mes en que se generaron). Vea Funcin Sum (campo, campocond, cond), ms adelante en este mismo captulo. y Si especifica un conjunto de valores individuales, puede calcular la desviacin estndar de los valores del conjunto. Vea Funcin Sum (x), ms adelante en este mismo captulo.

Sum (campo) Sum (campo, campocond) Sum (campo, campocond, cond) Sum (x)
Accin
Crystal Reports le permite sumar los valores que aparecen en el informe. Por ejemplo: y 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 Funcin Sum (campo), ms adelante en este mismo captulo.

Crystal Reports para Visual Basic 51

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 51 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

y Si divide los pedidos en grupos (por ejemplo, los pedidos agrupados segn 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 Funcin Sum (campo, campocond), ms adelante en este mismo captulo. y Si divide los pedidos en grupos de fecha o Booleanos (por ejemplo, pedidos agrupados segn 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 Funcin Sum (campo, campocond, cond), ms adelante en este mismo captulo. y Si especifica un conjunto de valores individuales, tambin puede calcular la suma de los valores del conjunto. Vea Funcin Sum (x), ms adelante en este mismo captulo.

Funcin Sum (campo)


Argumentos
campo es cualquier campo vlido de base de datos o de frmula que la funcin puede evaluar.

Valores que devuelve


Nmero fraccionario

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

Funcin Sum (campo, campocond)


Argumentos
y campo es cualquier campo vlido de base de datos o de frmula que la funcin puede evaluar. y campocond es cualquier campo vlido de base de datos o de frmula usado para agrupar los valores por campo.

Valores que devuelve


Nmero fraccionario

Accin
La funcin Sum (campo, campocond) resume cada grupo de valores que se genera cuando se cumple la condicin de resumen especificada

52 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 52 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

Funcin Sum (campo, campocond, cond)


Argumentos
y campo es cualquier campo vlido de base de datos o de frmula que la funcin puede evaluar. y campocond es cualquier campo de fecha o booleano vlido usado para agrupar los valores por campo. y cond es una cadena de texto que indica la condicin de campocond que controla el agrupamiento. Las cadenas vlidas para este argumento dependen de si campocond contiene valores de fecha o booleanos.

Valores que devuelve


Nmero fraccionario

Accin
La funcin Sum (campo, campocond, cond) resume cada grupo de valores que se genera cuando se cumple la condicin 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 condicin adicional.

Funcin Sum (x)


Argumentos
x es una matriz de valores que puede evaluar la funcin usada.

Valores que devuelve


Nmero fraccionario

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

Today
Valores que devuelve
Valor de fecha

Accin
Today devuelve la fecha actual.

Crystal Reports para Visual Basic 53

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 53 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

ToNumber(x)
Argumentos
x es una cadena de texto que contiene texto numrico.

Valores que devuelve


Nmero fraccionario

Accin
ToNumber convierte una cadena de texto en un nmero. En una base de datos, algunos nmeros se almacenan en campos numricos, como nmeros, y otros se almacenan en campos de tipo cadena, como texto. Cuando crea la base de datos determina cules son los campos que van a ser numricos y cules van a ser de texto. Los nmeros sobre los que puede querer realizar clculos (precio del producto, cantidad pedida, etc.) generalmente se almacenan en campos numricos; los nmeros sobre los que en principio no se espera realizar clculos (nmero de cliente, nmero de telfono, etc.) generalmente se almacenan como objetos de texto. ToNumber le permite convertir un nmero almacenado como texto en un nmero con el que puede realizar operaciones aritmticas.

ToText (x) ToText (x, lugares)


Argumentos
y x es un nmero que desea convertir en una cadena de texto. y lugares es un nmero entero que indica el nmero de posiciones decimales de x que se han de tener en cuenta.

Valores que devuelve


Cadena de texto

Accin
La funcin ToText convierte un nmero en una cadena de texto.

54 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 54 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

ToWords (x) ToWords (x, lugares)


Argumentos
y x es un nmero fraccionario que se va a convertir en palabras. y lugares es un nmero entero que indica el nmero de posiciones decimales que se van a convertir. (Este argumento es opcional.)

Valores que devuelve


Cadena de texto

Accin
Puede usar esta funcin para convertir en palabras el valor de un campo de nmero o moneda o el resultado de un clculo numrico, de forma que se pueda usar como texto. La posibilidad de ajustar el nmero de posiciones decimales puede ser til cuando el nmero es el resultado de un clculo que puede producir ms posiciones decimales que las deseadas.

TrimLeft (x)
Argumentos
x es una cadena de texto justificada a la derecha.

Valores que devuelve


Cadena de texto

Accin
TrimLeft elimina todos los espacios que hay a la izquierda de una cadena o un campo de datos que est almacenado con justificacin a la derecha en una base de datos.

Crystal Reports para Visual Basic 55

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 55 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

TrimRight (x)
Argumentos
x es una cadena de texto justificada a la izquierda.

Valores que devuelve


Cadena de texto

Accin
TrimRight elimina todos los espacios que hay a la derecha de una cadena o un campo de datos que est almacenado con justificacin a la izquierda en una base de datos..

Truncate (x)
Argumentos
x es un nmero fraccionario que se va a truncar.

Valores que devuelve


Nmero fraccionario

Accin
Truncate(x) devuelve un valor entero truncando el nmero desde el punto decimal.

UpperCase (x)
Argumentos
x es una cadena de texto.

Valores que devuelve


Cadena de texto

Accin
UpperCase imprime en maysculas la cadena de texto o el valor de texto del campo de datos.

56 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 56 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

Variance (campo) Variance (campo, campocond) Variance (campo, campocond, cond) Variance (x)
Accin
Crystal Reports le permite encontrar la varianza de un conjunto de valores del informe. Por ejemplo: y Puede calcular la varianza total para todos los valores de un campo. Vea Funcin Sum (campo), ms adelante en este mismo captulo. y Puede calcular la varianza para todos los valores de un grupo (por ejemplo, ventas agrupadas segn el estado que las originaron). Vea Funcin Sum (campo, campocond), ms adelante en este mismo captulo. y Puede calcular la varianza para todos los valores de un grupo, agrupado segn las variaciones de una fecha o un campo Booleano (por ejemplo, ventas agrupadas en funcin del mes en que se generaron). Vea Funcin Sum (campo, campocond, cond), ms adelante en este mismo captulo. y Si especifica un conjunto de valores individuales, puede calcular la varianza de los valores del conjunto. Vea Funcin Sum (x), ms adelante en este mismo captulo.

WeekToDateFromSun
Valores que devuelve
Ninguno

Accin
Especifica un intervalo de valores de fecha que incluye todos los das desde el ltimo domingo hasta hoy (incluyendo hoy).

Crystal Reports para Visual Basic 57

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 57 of 26 Printed: 07/22/11 06:05 PM

Captulo 4 Funciones

WhilePrintingRecords
Valores que devuelve
Ninguno

Accin
Fuerza al programa a evaluar la frmula mientras imprime datos de los registros de la base de datos.

WhileReadingRecords
Valores que devuelve
Ninguno

Accin
Fuerza al programa a evaluar la frmula 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


Nmero entero

Accin
Year extrae el ao de una fecha y lo devuelve como un nmero.

YearToDate
Valores que devuelve
Ninguno

Accin
Especifica un intervalo de valores de fecha que incluye todos los das desde el primer da del ao hasta la fecha.

58 Crystal Reports para Visual Basic

Filename: 51429034.docx Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: jescate Revision #: 2 Page: 58 of 26 Printed: 07/22/11 06:05 PM

Вам также может понравиться