48663173 4 funciones crystal report

Upload: amaya-paz-mejia

Post on 18-Jul-2015

635 views

Category:

Documents


4 download

TRANSCRIPT

C A P T U L O

4

Funciones

IntroduccinEste 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)Argumentosx es cualquier nmero.

Valores que devuelveValor absoluto de x.

AccinAbs 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 Aged61To90DaysValores que devuelveNinguno

AccinEspecifica 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 devuelveNinguno

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

AllDatesFromTomorrowValores que devuelveNinguno

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

AllDatesToTodayValores que devuelveNinguno

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

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

AllDatesToYesterdayValores que devuelveNinguno

AccinEspecifica 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)AccinCrystal 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

BeforeReadingRecordsValores que devuelveNinguno

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

Calendar1stHalf Calendar2ndHalfValores que devuelveNinguno

AccinEspecifica 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 Calendar4thQtrValores que devuelveNinguno

AccinEspecifica 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)AccinCrystal 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)Argumentosy 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 devuelveValor 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

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

Valores que devuelveNmero entero (el da del mes)

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

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

Valores que devuelveNmero entero

AccinDayOfWeek 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)AccinCrystal 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

GroupNumberValores que devuelveNmero entero

AccinDevuelve el nmero de grupo actual.

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

Valores que devuelveValor booleano

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

Last4WeeksToSunValores que devuelveNinguno

AccinEspecifica 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

Last7DaysValores que devuelveNinguno

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

LastFullMonthValores que devuelveNinguno

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

LastFullWeekValores que devuelveNinguno

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

LastYearMTDValores que devuelveNinguno

AccinEspecifica 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

LastYearYTDValores que devuelveNinguno

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

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

Valores que devuelveNmero entero

AccinLength 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)Argumentosx es una cadena de texto cuyos caracteres se van a convertir a minsculas.

Valores que devuelveCadena de texto

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

Valores que devuelveNmero entero

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

MonthToDateValores que devuelveNinguno

AccinEspecifica 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)Argumentoscampo es cualquier campo de base de datos o de frmula.

Valores que devuelveUn valor de campo del mismo tipo que el argumento.

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

Next30Days Next31To60Days Next61To90Days Next91To365DaysValores que devuelveNinguno

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

Valores que devuelveValor booleano

AccinEvala 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)Argumentosx es una cadena de texto en la que se va a comprobar si contiene texto numrico.

Valores que devuelveValor booleano

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

Over90DaysValores que devuelveNinguno

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

PageNumberValores que devuelveNmero entero

AccinPageNumber 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)AccinCrystal 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)AccinCrystal 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)Argumentoscampo es cualquier campo vlido de base de datos o de frmula.

Valores que devuelveUn valor de campo del mismo tipo que el argumento campo.

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

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

Valores que devuelveValor booleano

AccinEvala 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

PrintDateValores que devuelveValor de fecha

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

RecordNumberValores que devuelveNmero entero

AccinRecordNumber devuelve el nmero de registro actual.

Remainder (num, denom)Argumentosy num es un valor fraccionario. y denom es un valor fraccionario.

Valores que devuelveValor fraccionario

AccinRemainder 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)Argumentosy 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 devuelveCadena de texto

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

Round(x) Round(x, lugares)Argumentosy 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 devuelveNmero fraccionario

AccinRound 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)AccinCrystal 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)AccinCrystal 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)Argumentoscampo es cualquier campo vlido de base de datos o de frmula que la funcin puede evaluar.

Valores que devuelveNmero fraccionario

AccinLa 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)Argumentosy 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 devuelveNmero fraccionario

AccinLa 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)Argumentosy 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 devuelveNmero fraccionario

AccinLa 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)Argumentosx es una matriz de valores que puede evaluar la funcin usada.

Valores que devuelveNmero fraccionario

AccinSum(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.

TodayValores que devuelveValor de fecha

AccinToday 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)Argumentosx es una cadena de texto que contiene texto numrico.

Valores que devuelveNmero fraccionario

AccinToNumber 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)Argumentosy 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 devuelveCadena de texto

AccinLa 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)Argumentosy 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 devuelveCadena de texto

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

Valores que devuelveCadena de texto

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

Valores que devuelveCadena de texto

AccinTrimRight 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)Argumentosx es un nmero fraccionario que se va a truncar.

Valores que devuelveNmero fraccionario

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

UpperCase (x)Argumentosx es una cadena de texto.

Valores que devuelveCadena de texto

AccinUpperCase 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)AccinCrystal 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.

WeekToDateFromSunValores que devuelveNinguno

AccinEspecifica 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

WhilePrintingRecordsValores que devuelveNinguno

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

WhileReadingRecordsValores que devuelveNinguno

AccinFuerza al programa a evaluar la frmula 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 devuelveNmero entero

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

YearToDateValores que devuelveNinguno

AccinEspecifica 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