Función Sum (campo, campocond)
Anuncio
C A P Í T U L O 4 Funciones 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. Crystal Reports para Visual Basic 33 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 33 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones Aged0To30Days Aged31To60Days Aged61To90Days Valores que devuelve Ninguno Acción Especifica un intervalo de valores de las fechas comprendidas dentro de un periodo determinado de tiempo anterior a la fecha actual. Si la fecha actual es 30/12/98, Aged0To30Days especifica el periodo desde el 1/12/98 hasta la fecha actual, Aged31To60Days especifica el periodo comprendido entre el 1/11/98 y el 30/11/98, y Aged61To90Days especifica el periodo comprendido entre el 2/10/98 y el 31/10/98. AllDatesFromToday Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha que incluye cualquier fecha desde el día actual hasta cualquier valor de fecha futuro que pueda aparecer en el campo. AllDatesFromToday incluye el día actual. AllDatesFromTomorrow Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha desde el día actual. AllDatesFromTomorrow no incluye el día actual, pero sí incluye cualquier fecha futura. AllDatesToToday Valores que devuelve Ninguno 34 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 34 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones Acción Especifica un intervalo de valores de fecha que incluye todos los días anteriores al día actual. AllDatesToToday incluye el día actual. AllDatesToYesterday Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha que incluye todos los días anteriores hasta el día anterior al día actual. AllDatesToYesterday incluye todas las fechas anteriores al día de hoy, pero no incluye el día actual. Average (campo) Average (campo, campocond) Average (campo, campocond, cond) Average (x) Acción Crystal Reports le permite calcular el promedio de los valores que aparecen en el informe. Por ejemplo: Si un informe de ventas incluye un campo que muestra el importe de cada pedido, puede calcular el promedio de todos los pedidos que aparecen en el informe (promedio total general). Vea Función Sum (campo), más adelante en este mismo capítulo. Si divide los pedidos en grupos (por ejemplo, pedidos agrupados según el estado desde el que se realizaron), puede calcular el pedido promedio por grupo (en este caso, por estado). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo. Si divide los pedidos en función de la fecha o de valores Booleanos (por ejemplo, pedidos agrupados por el mes en el que se realizaron), puede calcular el pedido promedio de cada grupo en función de la variación del campo de fecha o Booleano (en este caso, por mes). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo. 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. Crystal Reports para Visual Basic 35 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 35 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones BeforeReadingRecords Valores que devuelve Ninguno Acción Especifica que la fórmula se va a evaluar antes de leer los registros de la base de datos. Calendar1stHalf Calendar2ndHalf Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha que incluye todas las fechas comprendidas en el primer o el segundo semestre del año, respectivamente. El primer semestre del año incluye todas las fechas desde el 1 de enero hasta el 30 de junio. El segundo semestre del año incluye todas las fechas desde el 1 de julio hasta el 31 de diciembre. Calendar1stQtr Calendar2ndQtr, Calendar3rdQtr Calendar4thQtr Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha que comprende el primer, segundo, tercer o cuarto trimestre del año. El primer trimestre del año incluye desde el 1 de enero hasta el 31 de marzo. El segundo trimestre del año incluye todas las fechas desde el 1 de abril hasta el 30 de junio. El tercer trimestre del año incluye desde el 1 de julio hasta el 30 de septiembre. El cuarto trimestre del año incluye desde el 1 de octubre hasta el 31 de diciembre. 36 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 36 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones Count (campo) Count (campo, campocond) Count (campo, campocond, cond) Count (x) Acción Crystal Reports le permite contar los valores que aparecen en el informe. Por ejemplo: 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 Crystal Reports para Visual Basic 37 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 37 of 26 Printed: 11/15/15 06:17 AM 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) Argumentos x es un valor de fecha o un valor de fecha y hora. Valores que devuelve Número entero (el día del mes) Acción Day extrae el día de un valor de fecha o fecha y hora y devuelve un número entero. DayOfWeek (x) Argumentos x es un valor de fecha o un valor de fecha-hora. Valores que devuelve Nú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. 38 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 38 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones DistinctCount (campo) DistinctCount (campo, campocond) DistinctCount (campo, campocond, cond) DistinctCount (x) Acción Crystal Reports le permite contar el número de valores distintos que aparecen en un informe. Por ejemplo: Si un informe de ventas incluye todos los pedidos realizados por los clientes, puede calcular el número total de clientes distintos que figuran en el informe (un recuento total de valores distintos), excluyendo los valores duplicados. Si un cliente realizó más de un pedido, se pasan por alto las ocurrencias duplicadas de ese cliente. Vea Función Sum (campo), más adelante en este mismo capítulo. Si divide los pedidos en grupos (por ejemplo, pedidos agrupados según el estado desde el que se realizaron), puede calcular el número de clientes distintos de cada grupo (en este caso, por estado). Cualquier cliente que realizó más de un pedido y aparece más de una vez en un grupo sólo se cuenta una vez. Vea Función Sum (campo, campocond), más adelante en este mismo capítulo. Si divide los pedidos en función de la fecha o de valores Booleanos (por ejemplo, pedidos agrupados por el mes en que se realizaron) puede calcular el número de clientes distintos de cada grupo en función de la variación del campo de fecha o Booleano (en este caso, por el número de clientes que realizaron pedidos cada mes). Si un cliente realizó más de un pedido durante el mes, las instancias duplicadas del cliente se pasan por alto. Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo. Si especifica un conjunto de valores individuales, puede calcular el número de valores distintos del conjunto. Los valores duplicados del conjunto sólo se cuentan una vez. Vea Función Sum (x), más adelante en este mismo capítulo. Crystal Reports para Visual Basic 39 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 39 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones GroupNumber Valores que devuelve Número entero Acción Devuelve el número de grupo actual. IsNull (campo) Argumentos campo es cualquier campo válido de base de datos. Valores que devuelve Valor booleano Acción Evalúa el campo especificado en el registro actual y devuelve TRUE si el campo contiene un valor nulo. Last4WeeksToSun Valores que devuelve Ninguno Acción Especifica un intervalo de fechas que incluye las cuatro últimas semanas anteriores al domingo pasado. La semana comienza en lunes y acaba en domingo. Por ejemplo, Septiembre 1996 empieza en domingo. Si hoy es 22 de septiembre (domingo), Last4WeeksToSun empieza el 26 de agosto (lunes) y finaliza el 22 de septiembre (hoy, domingo). Si hoy es 28 de septiembre (sábado), Last4WeeksToSun comienza el 26 de agosto (lunes) y finaliza el 22 de septiembre (el domingo anterior). 40 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 40 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones Last7Days Valores que devuelve Ninguno Acción Especifica un intervalo de valores que incluye todas las fechas desde hace siete días hasta hoy (incluyendo hoy). LastFullMonth Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha que incluye todas las fechas desde el primer hasta el último día del mes anterior. LastFullWeek Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha que incluye todas las fechas desde el domingo hasta el sábado de la semana anterior. LastYearMTD Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha del año anterior que comprende el periodo del mes actual hasta la fecha. Crystal Reports para Visual Basic 41 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 41 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones LastYearYTD Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha que incluye todas las fechas del año pasado, hasta la fecha actual del año anterior. Length(x) Argumentos x es una cadena de texto o campo que contiene una cadena de texto. Valores que devuelve Número entero Acción Length 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) Argumentos x 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. 42 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 42 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones Maximum (campo) Maximum (campo, campocond) Maximum (campo, campocond, cond) Maximum (x) Acción Crystal Reports le permite encontrar el valor máximo que aparece en un conjunto de valores. Por ejemplo: Si un informe de ventas incluye un campo que muestra el importe de cada pedido, puede encontrar el mayor importe de pedido entre todos los pedidos que aparecen en el informe (el máximo importe total). Vea Función Sum (campo), más adelante en este mismo capítulo. Si divide los pedidos en grupos (por ejemplo, pedidos agrupados por el estado desde el que se realizaron) puede encontrar el mayor importe de pedido de cada grupo (en este caso, por estado). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo. Si divide los pedidos en función de la fecha o de valores Booleanos (por ejemplo, pedidos agrupados por el mes en que se realizaron), puede encontrar el mayor importe de pedido de cada grupo en función de la variación del campo fecha o Booleano (en este caso, por meses) Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo. Si especifica un conjunto de valores individuales, puede encontrar el valor máximo del conjunto. Vea Función Sum (x), más adelante en este mismo capítulo. Minimum (campo) Minimum (campo, campocond) Minimum (campo, campocond, cond) Minimum (x) Acción Crystal Reports le permite encontrar el valor mínimo que aparece en un conjunto de valores. Por ejemplo: Crystal Reports para Visual Basic 43 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 43 of 26 Printed: 11/15/15 06:17 AM 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) Argumentos x es un valor de fecha o un valor de fecha-hora. Valores que devuelve Nú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. MonthToDate Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha que incluye todas las fechas desde el primer día del mes hasta hoy. 44 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 44 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones Next(campo) Argumentos campo es cualquier campo de base de datos o de fórmula. Valores que devuelve Un valor de campo del mismo tipo que el argumento. Acción Next(campo) devuelve el valor del campo especificado en el registro siguiente. Next30Days Next31To60Days Next61To90Days Next91To365Days Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha que incluye todas las fechas dentro del periodo especificado a partir de hoy (incluye hoy). NextIsNull(campo) Argumentos campo es cualquier campo de base de datos o de fórmula. Valores que devuelve Valor booleano Acción Evalúa el campo especificado en el siguiente registro y devuelve TRUE si el campo contiene un valor nulo. Crystal Reports para Visual Basic 45 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 45 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones NumericText(x) Argumentos x es una cadena de texto en la que se va a comprobar si contiene texto numérico. Valores que devuelve Valor booleano Acción NumericText comprueba si el contenido de un objeto de texto es un número. Si todo el contenido del campo es un número o si los caracteres obtenidos mediante el operador de subíndice son íntegramente un número, la expresión devuelve el valor TRUE. Si cualquier parte del contenido del campo o de los caracteres obtenidos no es un número, la expresión devuelve el valor FALSE. Over90Days Valores que devuelve Ninguno Acción Especifica un intervalo de valores que incluye todos los valores que son 90 días más antiguos que la fecha actual. PageNumber Valores que devuelve Número entero Acción PageNumber inserta el número de página actual como un campo dentro de una fórmula. 46 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 46 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones PopulationStdDev (campo) PopulationStdDev (campo, campocond) PopulationStdDev (campo, campocond, cond), PopulationStdDev (x) Acción Crystal Reports le permite encontrar la desviación estándar de la población de un conjunto de valores del informe. Por ejemplo: Puede calcular la desviación estándar total de la población para todos los valores de un campo. Vea Función Sum (campo), más adelante en este mismo capítulo. Puede calcular la desviación estándar de la población para todos los valores de un grupo (por ejemplo, ventas agrupadas según el estado donde se generaron). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo. Puede calcular la desviación estándar de la población para todos los valores de un grupo, agrupado según las variaciones de una fecha o un campo Booleano (por ejemplo, ventas agrupadas en función del mes en que se generaron). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo. Si especifica un conjunto de valores individuales, puede calcular la desviación estándar de la población de los valores de este conjunto. Vea Función Sum (x), más adelante en este mismo capítulo. PopulationVariance (campo) PopulationVariance (campo, campocond) PopulationVariance (campo, campocond, cond) PopulationVariance (x) Acción Crystal Reports le permite encontrar la varianza de la población en un conjunto de valores del informe. Por ejemplo: Crystal Reports para Visual Basic 47 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 47 of 26 Printed: 11/15/15 06:17 AM 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) Argumentos campo es cualquier campo válido de base de datos o de fórmula. Valores que devuelve Un valor de campo del mismo tipo que el argumento campo. Acción Previous(campo) devuelve el valor que tiene el campo especificado en el registro anterior. PreviousIsNull(campo) Argumentos campo es cualquier campo válido de base de datos o de fórmula. Valores que devuelve Valor booleano Acción Evalúa el campo especificado en el registro anterior y devuelve TRUE si el campo contiene un valor nulo. 48 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 48 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones PrintDate Valores que devuelve Valor de fecha Acción PrintDate inserta la fecha en la que se imprime el informe como un campo dentro de una formula. RecordNumber Valores que devuelve Número entero Acción RecordNumber devuelve el número de registro actual. Remainder (num, denom) Argumentos num es un valor fraccionario. denom es un valor fraccionario. Valores que devuelve Valor fraccionario Acción Remainder devuelve el resto después de dividir el numerador (dividendo) por el denominador (divisor). En una situación de división típica, Crystal Reports expresa 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. Crystal Reports para Visual Basic 49 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 49 of 26 Printed: 11/15/15 06:17 AM 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. 50 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 50 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones StdDev (campo) StdDev (campo, campocond) StdDev (campo, campocond, cond) StdDev (x) Acción Crystal Reports le permite encontrar la desviación estándar de un conjunto de valores del informe. Por ejemplo: Puede calcular la desviación estándar total para todos los valores de un campo. Vea Función Sum (campo), más adelante en este mismo capítulo. Puede calcular la desviación estándar para todos los valores de un grupo (por ejemplo, ventas agrupadas según el estado en que se originaron). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo. Puede calcular la desviación estándar para todos los valores de un grupo, agrupado según las variaciones de una fecha o un campo Booleano (por ejemplo, ventas agrupadas en función del mes en que se generaron). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo. Si especifica un conjunto de valores individuales, puede calcular la desviación estándar de los valores del conjunto. Vea Función Sum (x), más adelante en este mismo capítulo. Sum (campo) Sum (campo, campocond) Sum (campo, campocond, cond) Sum (x) Acción Crystal Reports le permite sumar los valores que aparecen en el informe. Por ejemplo: Si un informe de ventas incluye un campo que muestra el importe de cada pedido, puede calcular la suma de todos los pedidos que aparecen en el informe (suma total general). Vea Función Sum (campo), más adelante en este mismo capítulo. Crystal Reports para Visual Basic 51 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 51 of 26 Printed: 11/15/15 06:17 AM 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) Argumentos campo es cualquier campo válido de base de datos o de fórmula que la función puede evaluar. Valores que devuelve Número fraccionario Acción La función Sum (campo) resume los valores del campo especificado a lo largo de todo el informe. Genera un resumen de "total general". 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 52 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 52 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones 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) Argumentos x 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. Today Valores que devuelve Valor de fecha Acción Today devuelve la fecha actual. Crystal Reports para Visual Basic 53 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 53 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones ToNumber(x) Argumentos x 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ón La función ToText convierte un número en una cadena de texto. 54 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 54 of 26 Printed: 11/15/15 06:17 AM 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) Argumentos x 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. Crystal Reports para Visual Basic 55 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 55 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones TrimRight (x) Argumentos x es una cadena de texto justificada a la izquierda. Valores que devuelve Cadena de texto Acción TrimRight elimina todos los espacios que hay a la derecha de una cadena o un campo de datos que está almacenado con justificación a la izquierda en una base de datos.. Truncate (x) Argumentos x es un número fraccionario que se va a truncar. Valores que devuelve Número fraccionario Acción Truncate(x) devuelve un valor entero truncando el número desde el punto decimal. UpperCase (x) Argumentos x es una cadena de texto. Valores que devuelve Cadena de texto Acción UpperCase imprime en mayúsculas la cadena de texto o el valor de texto del campo de datos. 56 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 56 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones Variance (campo) Variance (campo, campocond) Variance (campo, campocond, cond) Variance (x) Acción Crystal Reports le permite encontrar la varianza de un conjunto de valores del informe. Por ejemplo: Puede calcular la varianza total para todos los valores de un campo. Vea Función Sum (campo), más adelante en este mismo capítulo. Puede calcular la varianza para todos los valores de un grupo (por ejemplo, ventas agrupadas según el estado que las originaron). Vea Función Sum (campo, campocond), más adelante en este mismo capítulo. Puede calcular la varianza para todos los valores de un grupo, agrupado según las variaciones de una fecha o un campo Booleano (por ejemplo, ventas agrupadas en función del mes en que se generaron). Vea Función Sum (campo, campocond, cond), más adelante en este mismo capítulo. Si especifica un conjunto de valores individuales, puede calcular la varianza de los valores del conjunto. Vea Función Sum (x), más adelante en este mismo capítulo. WeekToDateFromSun Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha que incluye todos los días desde el último domingo hasta hoy (incluyendo hoy). Crystal Reports para Visual Basic 57 Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 57 of 26 Printed: 11/15/15 06:17 AM Capítulo 4 Funciones WhilePrintingRecords Valores que devuelve Ninguno Acción Fuerza al programa a evaluar la fórmula mientras imprime datos de los registros de la base de datos. WhileReadingRecords Valores que devuelve Ninguno Acción Fuerza al programa a evaluar la fórmula mientras lee datos de los registros de la base de datos. Year(x) Argumentos x es un valor de fecha o un valor de fecha y hora. Valores que devuelve Número entero Acción Year extrae el año de una fecha y lo devuelve como un número. YearToDate Valores que devuelve Ninguno Acción Especifica un intervalo de valores de fecha que incluye todos los días desde el primer día del año hasta la fecha. 58 Crystal Reports para Visual Basic Filename: 420325850.doc Project: CHAPTER 0 Template: NAETUGP.DOT Author: AM Last Saved By: SusanaCharles Revision #: 2 Page: 58 of 26 Printed: 11/15/15 06:17 AM