Funciones de Visual FoxPro 6.0

Funciones Matematicas

Función de Visual Basic 6	Método en .NET Framework	Descripción
Abs	Abs	Devuelve el valor absoluto de un número especificado.
Atn	Atan	Devuelve un valor Double que contiene el ángulo cuya tangente es el número especificado.
Cos	Cos	Devuelve un valor Double que contiene el coseno del ángulo especificado.
Exp	Exp	Devuelve un valor Double que contiene e (base de los logaritmos naturales) elevado a la potencia especificada.
Log	Log	Devuelve un valor Double que contiene el logaritmo del número especificado. Este método está sobrecargado y puede devolver o bien el logaritmo natural (de base e) del número especificado o bien el logaritmo del número especificado en una base especificada.
Round	Round	Devuelve un valor de tipo Doubleque contiene el número más próximo al valor especificado. Existen funciones de redondeo adicionales disponibles como métodos de los tipos intrínsecos, tales como Round.
Sgn	Sign	Devuelve un valor Integer que indica el signo de un número.
Sin	Sin	Devuelve un valor Double que especifica el seno de un ángulo.
Sqr	Sqrt	Devuelve un valor Double que especifica la raíz cuadrada de un número.
Tan	Tan	Devuelve un valor Double que contiene la tangente de un ángulo.

Además, la clase matemática de .NET Framework ofrece constantes y otros métodos estáticos para funciones trigonométricas, logarítmicas y otras funciones matemáticas habituales. Todo ello puede utilizarse en un programa de Visual Basic.

Funciones Fecha

DateAdd

Devuelve un valor de tipo Date que contiene un valor de fecha y hora al que se ha agregado un intervalo de tiempo especificado.

Public Overloads Function DateAdd( _
ByVal Interval As DateInterval, _

 DateValue As DateTime _
) A
ByVal Number As Double, _
   ByVa
ls DateTime
' -or-
Public Overloads Function DateAdd( _

, _
   ByVal DateValue As Obje
ByVal Interval As String, _
   ByVal Number As Doubl
ect _

ateTime

) As 
D

Parámetros

Interval

Obligatorio. Valor de enumeración DateInterval o expresiónString que representa el intervalo de tiempo que se desea agregar.

Number

Obligatorio. Double. Expresión de punto flotante que representa el número de intervalos que se desea agregar.Number puede ser un valor positivo (para obtener fechas u horas futuras) o negativo (para obtener fechas u horas pasadas). Se omite cualquier fracción de Number.

DateValue

Obligatorio. Date. Expresión que representa la fecha y la hora a las que se debe agregar el intervalo. No se cambiaDateValue en el programa de llamada.

Valores

---

El argumento Interval puede tener uno de los siguientes valores:

Valor de enumeración	Cadena	Unidad de intervalo de tiempo agregada
DateInterval.Day	d	Día; truncado al valor integral
DateInterval.DayOfYear	y	Día; truncado al valor integral
DateInterval.Hour	h	Hora; truncada al valor integral
DateInterval.Minute	n	Minuto; truncado al valor integral
DateInterval.Month	m	Mes; truncado al valor integral
DateInterval.Quarter	q	Trimestre; truncado al valor integral
DateInterval.Second	s	Segundo; truncado al valor integral
DateInterval.Weekday	w	Día; truncado al valor integral
DateInterval.WeekOfYear	ww	Semana; truncada al valor integral
DateInterval.Year	yyyy	Año; truncado al valor integral

Excepciones

---

Tipo de excepción	Número de error	Condición
InvalidCastException	13	DateValue no es convertible enDate.
ArgumentException	5	El intervalo no es válido.
ArgumentOutOfRangeException	9	La fecha calculada es anterior a las 00:00:00 horas del 1 de enero del año 1 o posterior a las 23:59:59 del 31 de diciembre de 9999.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

DateDiff

Devuelve un valor Long que especifica el número de intervalos de tiempo entre dos valores Date.

Public Overloads Function DateDiff( _

    ByVal Interval As [ DateInterval | String ], _
ByVal Date1 As DateTime, _

    Optional ByVal DayOfWeek A
ByVal Date2 As DateTime, _

ek.Sunday, _
    Optional ByVal  WeekOfYear
s FirstDayOfWeek = FirstDayOfW
e As FirstWeekOfYear = FirstWeekOfYear.Jan1 _


) As Long

Parámetros

Interval

Obligatorio. Valor de enumeración DateInterval o expresiónString que representa el intervalo de tiempo que se desea utilizar como unidad de diferencia entre Date1 y Date2.

Date1

Obligatorio. Date. Primer valor de fecha u hora que se desea utilizar en el cálculo.

Date2

Obligatorio. Date. Segundo valor de fecha u hora que se desea utilizar en el cálculo.

DayOfWeek

Opcional. Un valor elegido de la enumeraciónFirstDayOfWeek que especifica el primer día de la semana. Si no se especifica, se utiliza FirstDayOfWeek.Sunday.

WeekOfYear

Opcional. Un valor elegido de la enumeraciónFirstWeekOfYear que especifica la primera semana del año. Si no se especifica, se utiliza FirstWeekOfYear.Jan1.

Configuración

---

El argumento Interval puede tener uno de los siguientes valores:

Valor de enumeración	Valor String	Unidad de diferencia temporal
DateInterval.Day	"d"	Día
DateInterval.DayOfYear	"y"	Día
DateInterval.Hour	"h"	Hora
DateInterval.Minute	"n"	Minuto
DateInterval.Month	"m"	Mes
DateInterval.Quarter	"q"	Trimestre
DateInterval.Second	"s"	Segundo
DateInterval.Weekday	"w"	Semana
DateInterval.WeekOfYear	"ww"	Semana del calendario
DateInterval.Year	"yyyy"	Año

El argumento DayOfWeek puede tener uno de los siguientes valores:

Valor de enumeración	Valor	Descripción
FirstDayOfWeek.System	0	Primer día de la semana especificado en la configuración del sistema
FirstDayOfWeek.Sunday	1	Domingo (predeterminado)
FirstDayOfWeek.Monday	2	Lunes (de acuerdo con la norma ISO 8601, sección 3.17)
FirstDayOfWeek.Tuesday	3	Martes
FirstDayOfWeek.Wednesday	4	Miércoles
FirstDayOfWeek.Thursday	5	Jueves
FirstDayOfWeek.Friday	6	Viernes
FirstDayOfWeek.Saturday	7	Sábado

El argumento WeekOfYear puede tener uno de los siguientes valores:

Valor de enumeración	Valor	Descripción
FirstWeekOfYear.System	0	Primera semana del año especificada en la configuración del sistema
FirstWeekOfYear.Jan1	1	Semana en la que se encuentra el 1 de enero (predeterminado)
FirstWeekOfYear.FirstFourDays	2	Semana que contiene al menos cuatro días del nuevo año (de acuerdo con la norma ISO 8601, sección 3.17)
FirstWeekOfYear.FirstFullWeek	3	Primera semana completa del nuevo año

Excepciones

---

Tipo de excepción	Número de error	Condición
ArgumentException	5	Interval no válido.
ArgumentException	5	Date1, Date2 o DayofWeekestá fuera del intervalo.
InvalidCastException	13	Date1 o Date2 pertenece a un tipo no válido.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, debe considerarse la posibilidad de sustituir dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Funciones Financiera

Realiza operaciones financieras y estadísticas en campos de una tabla o expresiones que utilicen campos.

CALCULATE eExpressionList [Scope] [FOR lExpression1] [WHILE lExpression2]
[TO VarList | TO ARRAY ArrayName] [NOOPTIMIZE] 


[IN nWorkArea | cTableAlias]

Parámetros

eExpressionList

Especifica las expresiones que pueden contener cualquier combinación de las siguientes funciones:

AVG(nExpression)

CNT( )

MAX(eExpression)

MIN(eExpression)

NPV(nExpression1, nExpression2 [, nExpression3])

STD(nExpression)

SUM(nExpression)

VAR(nExpression)

Las funciones de la lista eExpressionList están separadas con comas. Estas funciones son específicas de CALCULATE y se describen detalladamente más adelante en esta sección. No deben confundirse con funciones independientes de nombre similar. Por ejemplo, CALCULATE MIN( ) no es lo mismo que MIN( ).

Scope

Especifica un intervalo de registros utilizados en el cálculo. Solamente se incluyen en dicho cálculo los registros incluidos en el intervalo. Las cláusulas de alcance son: ALL, NEXTnRecords, RECORD nRecordNumber y REST. Para obtener más información acerca de las cláusulas de alcance, vea el temaCláusulas de alcance. Los comandos que incluyen Scope sólo actúan sobre la tabla del área de trabajo activa.

El alcance predeterminado de CALCULATE es ALL (todos los registros).

FOR lExpression1

Especifica que sólo los registros que satisfacen la condición lógica lExpression1 se incluirán en el cálculo. La inclusión de FOR permite incluir registros en el cálculo de manera condicional, al filtrar los registros no deseados.

Rushmore optimizará una consulta CALCULATE ... FOR silExpression1 es una expresión optimizable. Para obtener el máximo rendimiento, utilice una expresión optimizable en la cláusula FOR. Si desea obtener más información acerca de las expresiones optimizables con Rushmore, vea SET OPTIMIZE yUtilizar Rushmore para agilizar el acceso a los datos.

WHILE lExpression2

Especifica una condición por la cual los registros se incluyen en el cálculo siempre y cuando la expresión lógicalExpression2 dé como resultado verdadero (.T.).

TO VarList

Especifica una o varias variables donde se almacenan los resultados del cálculo. Si una variable especificada no existe, Visual FoxPro la creará automáticamente con el nombre que usted especifique.

TO ARRAY ArrayName

Especifica el nombre de la matriz donde se pueden almacenar los resultados del cálculo. Si el nombre de matriz especificado no existe, Visual FoxPro creará automáticamente una matriz con este nombre. Si la matriz existe pero no es suficientemente grande para contener todos los resultados, Visual FoxPro aumentará automáticamente su tamaño para dar cabida a la información. Si una matriz existente es mayor de lo necesario, los elementos adicionales permanecerán sin cambios. Los resultados se almacenan en los elementos de la matriz en el orden en que se especifican en el comando CALCULATE.

NOOPTIMIZE

Desactiva la optimización Rushmore de CALCULATE. Si desea obtener más información, vea SET OPTIMIZE y Utilizar Rushmore para agilizar el acceso a los datos.

AVG(nExpression)

Calcula la media aritmética de nExpression. Sólo se incluyen en el resultado los registros que cumplan las condiciones deScope y/o de las cláusulas opcionales FOR o WHILE.

CNT( )

Devuelve el número de registros de la tabla. Sólo se incluyen en el resultado los registros que cumplan las condiciones deScope y/o de las cláusulas opcionales FOR o WHILE.

MAX(eExpression)

Devuelve el valor mayor o el más reciente de eExpression. En la cláusula MAX( ) es posible especificar cualquier campo (Character, Date, DateTime, Numeric, Float, Integer, Double o Currency) o cualquier expresión válida que utilice campos de estos tipos. Sólo se incluyen en el resultado los registros que cumplan las condiciones de Scope y/o de las cláusulas opcionales FOR o WHILE.

MIN(eExpression)

Devuelve el valor menor o el más antiguo de eExpression. EneExpression es posible especificar cualquier campo (Character, Date, DateTime, Numeric, Float, Integer, Double o Currency) o cualquier expresión válida que utilice campos de estos tipos. Sólo se incluyen en el resultado los registros que cumplan las condiciones de Scope y/o de las cláusulas opcionales FOR o WHILE.