VBScript

En VBScript existe una librer�a de funciones predefinidas que el usuario puede emplear si lo considera conveniente. Al estar predefinidas no es necesario hacer nada para cargarlas en memoria. Se cargan, autom�ticamente, con el int�rprete. Solo es necesario invocarlas donde se necesiten. Estas funciones se clasifican en grupos en base al tipo de datos con el que se emplean. Veamos cuales son y que hacen:

ABS (n�mero)

Recibe como argumento un n�mero (o variable que lo contiene) y devuelve el mismo n�mero sin signo. No produce ning�n efecto con n�meros positivos y elimina el signo en los negativos.

ARRAY (Elemento1, Elemento2, ... , Elemento N)

Devuelve una matriz con los elementos que recibe, separados por comas, como argumento. Si no se le pasan argumentos, devuelve una matriz de cero elementos.

ASC (car�cter)

Devuelve el valor ASCII del car�cter que recibe como argumento. Si recibe una cadena, devuelve el c�digo ASCII del primer car�cter de la misma. Si recibe un dato Null, devuelve un valor Null.

ATN (n�mero)

Recibe un n�mero (o variable que lo contiene) que representa a un �ngulo en radianes y devuelve el arco tangente de ese �ngulo.

CBOOL (n�mero)

Recibe como argumento un n�mero (o variable que lo contiene y devuelve un valor l�gico. Falso si el n�mero es 0 y verdadero en otro caso.

CBYTE (n�mero)

Recibe como argumento un n�mero (o variable que lo contiene) y lo convierte a un n�mero en formato Byte.

CCUR (n�mero)

Recibe como argumento un n�mero (o variable que lo contiene) y lo convierte a un n�mero en formato Currency.

CDATE (cadena)

Recibe como argumento una cadena alfanum�rica representando una fecha y la convierte en un dato se subtipo DATE.

CDBL (n�mero)

Recibe como argumento un n�mero (o variable que lo contiene) y lo transforma a un n�mero en formato Double.

CHR (n�mero)

Devuelve el car�cter asociado al c�digo ASCII pasado como argumento. El n�mero deber� estar comprendido entre 0 y 255.

CINT (n�mero)

Recibe como argumento un n�mero (o variable que lo contiene) y lo transforma en un dato con formato Int.

CLNG (n�mero)

Recibe como argumento un n�mero (o variable que lo contiene) y lo transforma en un dato con formato Long.

COS (n�mero)

Recibe un n�mero (o variable que lo contiene) que representa a un �ngulo en radianes y devuelve el coseno de ese �ngulo.

CSNG (n�mero)

Recibe como argumento un n�mero (o variable que lo contiene) y lo transforma en un dato con formato Single.

CSTR (argumento)

Recibe como argumento un dato (o variable que lo contiene) que no sea una cadena alfanum�rica y lo devuelve transformado en una cadena.

DATE ()

No recibe ning�n argumento y devuelve la fecha del sistema.

DATEADD (intervalo, cantidad, fecha)

Esta funci�n devuelve el resultado de sumarle un periodo de tiempo a una fecha determinada. Recibe tres par�metros obligatorios:

El intervalo es una cadena de texto que indica la unidad de tiempo que queremos a�adir a la fecha (horas, d�as, etc). Los posibles valores est�n indicados a continuaci�n.

La cantidad es el n�mero de unidades del intervalo especificado que se le sumar� a la fecha indicada. Este valor puede ser positivo, para referirse a fechas futuras o negativo para referirse a fechas pasadas.

La fecha es aquella a la que se le suman los intervalos especificados para que la funci�n devuelva una nueva fecha como resultado de la operaci�n.

Por ejemplo. Si tecleamos la siguiente l�nea de c�digo:

	
nueva = DATEADD ("yyyy",1,10-02-1996) resultado ser� 10-02-1997.

Esta funci�n tiene en cuenta incluso los a�os bisiestos.

DATEDIFF (intervalo, fecha 1, fecha2)

Calcula la diferencia entre las dos fechas especificadas y la devuelve expresada en los periodos indicados en intervalo. Por lo tanto devuelve un resultado num�rico. Los posibles intervalos a especificar son los mismos que en el caso anterior.

DAY (fecha)

Esta funci�n recibe como argumento una fecha y devuelve un n�mero que corresponde al d�a del mes de la fecha indicada.

EXP (n�mero)

Recibe como argumento un n�mero (o variable que lo contiene) y devuelve el n�mero e elevado a la potencia indicada.

FIX (n�mero)

Recibe un n�mero (o variable que lo contiene). Devuelve la parte entera de un n�mero, truncando los decimales. Si el argumento es un n�mero negativo, esta funci�n devuelve el primer negativo igual o mayor que encuentre.

FORMATCURRENCY (n�mero, d�gitos_decimales, cero_decimal, negativos_par�ntesis, agrupar_d�gitos)

Esta funci�n se usa para representar n�meros en formato de moneda, es decir, con la apariencia de valores econ�micos. Recibe cuatro argumentos. El primero de ellos es el n�mero (o variable que lo contiene) que hay que representar como cifra econ�mica. Los otros tres son opcionales.

El par�metro d�gitos_decimales especifica cuantos d�gitos se quiere que aparezcan a la derecha de la coma digital.

El par�metro cero_decimal indica si se quiere completar el n�mero con ceros a la derecha de los decimales. P.e. Si se especificaron dos decimales en el par�metro anterior y un n�mero tiene un solo decimal �Queremos un cero a la derecha de ese decimal? Si lo queremos, este par�metro ser� un -1. Si no lo queremos, el par�metro ser� 0.

El par�metro negativos_par�ntesis especifica si queremos que los n�meros negativos aparezcan entre par�ntesis. Si lo queremos, pondremos -1. Si no, un 0.

El par�metro agrupar_d�gitos indica si queremos que los d�gitos aparezcan agrupados de tres en tres, en millares, millones, etc. Si lo queremos pondremos un -1. Si no lo deseamos as�, pondremos un 0.

Estos tres �ltimos par�metros pueden recibir como valor, en lugar de -1 o 0, un -2. En �ste �ltimo caso se toman las caracter�sticas establecidas en la configuraci�n regional del sistema, en el panel de control de Windows.

FORMATNUMBER (n�mero, d�gitos_decimales, cero_decimal, negativos_par�ntesis, agrupar_d�gitos)

Esta funci�n opera igual que la anterior, solo que se refiere a un formato gen�rico, sin asociar a ninguna moneda.

HEX (n�mero)

Recibe como argumento un n�mero decimal (o variable que lo contiene) y lo convierte en hexadecimal.

HOUR (hora)

Esta funci�n recibe como argumento una variable que contiene una hora en formato hh:mm:ss y devuelve la hora como un n�mero de 0 a 23.

INSTR (comienzo, cadena 1, cadena 2)

Busca la primera aparici�n de la cadena 2 dentro de la cadena 1. Los par�metros comienzo y comparaci�n son opcionales. El par�metro comienzo indica a partir de que car�cter de la cadena 1 se empieza a buscar la cadena 2. Si se omite, la b�squeda se inicia desde el primer car�cter.

INSTRREV (cadena 1, cadena 2, comienzo)

Esta funci�n es similar a la anterior, solo que empieza la b�squeda por el final de la cadena.

INT (n�mero)

Recibe un n�mero (o variable que lo contiene). Devuelve la parte entera de un n�mero, truncando los decimales. Si el argumento es un n�mero negativo, esta funci�n devuelve el primer negativo igual o menor que encuentre.

ISARRAY (variable)

Esta funci�n recibe como argumento un nombre de una variable y comprueba si es una matriz. Devuelve un valor booleano.

ISDATE (variable)

Esta funci�n recibe como argumento el nombre de una variable y comprueba si es una fecha. Devuelve un valor booleano.

ISEMPTY (variable)

Esta funci�n recibe como argumento el nombre de una variable. Devuelve un valor booleano. Es verdadero si la variable no est� inicializada y falso si lo est�

ISNULL (variable)

Esta funci�n recibe como argumento un nombre de variable y devuelve un valor l�gico. Verdadero si la variable contiene un Null. Falso si no lo contiene.

ISNUMERIC (variable)

Recibe una variable, supuestamente num�rica. Devuelve un valor l�gico verdadero si el par�metro que ha recibido es una variable que contiene un n�mero y un valor l�gico falso en caso contrario.

LCASE (cadena)

Recibe como argumento una cadena (o una variable que contiene una cadena) y la convierte a min�sculas.

LEFT (cadena, longitud)

Devuelve una sub-cadena compuesta por los caracteres que hay a la izquierda de una cadena. Los argumentos que recibe son una cadena (o variable que la contiene) y la longitud (cantidad de caracteres) de la sub-cadena.

LEN (cadena)

Recibe como argumento una cadena (o variable que la contiene) y devuelve la cantidad de caracteres que componen dicha cadena.

LOG (n�mero)

Esta funci�n recibe como argumento un n�mero (o una variable que lo contenga) que deber� ser mayor de 0 y devuelve el logaritmo en base e de dicho n�mero.

LTRIM (cadena)

Recibe como argumento una cadena o variable que la contiene. Devuelve la cadena sin los espacios en blanco que hay a la izquierda de la misma.

MID (cadena, inicio, longitud)

Recibe como argumentos una cadena (o variable que la contiene), una posici�n de inicio (o variable num�rica que la contiene) y una longitud (o variable num�rica que la contiene). Devuelve una sub-cadena extra�da de una cadena original. La sub cadena tiene los caracteres expresados en longitud, contados a partir del car�cter inicio. Por lo tanto, el primer argumento es alfanum�rico y los otros dos son num�ricos.

MINUTE (hora)

Esta funci�n recibe como argumento una variable que contiene una hora en formato hh:mm:ss y devuelve los minutos como un n�mero de 0 a 59.

MONTH (fecha)

Esta funci�n recibe como argumento una fecha o una variable de fecha y devuelve un n�mero del 1 al 12 que indica el mes de la fecha.

MONTHNAME (mes, abreviado)

Esta funci�n recibe como argumento un n�mero del 1 al 12 (o una variable que lo contiene) y devuelve el nombre del mes correspondiente. El otro par�metro que recibe es un valor l�gico para indicar si el nombre debe aparecer abreviado o no.

OCT (n�mero)

Recibe como argumento un n�mero decimal (o variable que lo contiene) y lo convierte en octal.

REPLACE (cadena 1, cadena 2, cambia_por, comienzo, veces)

Esta funci�n encuentra la cadena 2 dentro de la cadena 1 y la sustituye por cambia_por. Comienza a buscar a partir del car�cter cuyo n�mero de orden es el indicado en comienzo y, si la cadena_2 aparece mas de una vez en la cadena 1 la cambia el n�mero de veces indicado.

RIGHT (cadena, longitud)

Devuelve una sub-cadena compuesta por los caracteres que hay a la derecha de una cadena. Los argumentos que recibe son una cadena (o variable que la contiene) y la longitud (cantidad de caracteres) de la sub-cadena.

RND()

Recibe un argumento vac�o y devuelve un n�mero aleatorio. Para que funcione correctamente, es necesario incluir en el c�digo VBScript una l�nea con la instrucci�n RANDOMIZE.

ROUND (n�mero, decimales)

Esta funci�n redondea el n�mero (o variable que lo contiene) y lo devuelve con el n�mero de decimales expresado en decimales.

RTRIM (cadena)

Recibe como argumento una cadena o variable que la contiene. Devuelve la cadena sin los espacios en blanco que hay a la derecha de la misma.

SCRIPTENGINEBUILDVERSION ()

Esta funci�n no recibe ning�n argumento y devuelve el n�mero de versi�n del motor de Script que se est� utilizando.

SECOND (hora)

Esta funci�n recibe una expresi�n de hora en formato hh:mm:ss y devuelve el n�mero de segundos correspondiente.

SGN (numero)

Recibe un argumento num�rico y devuelve un 1 si el n�mero es positivo, un -1 si es negativo y un 0 si es 0.

SIN (n�mero)

Recibe un n�mero (o variable que lo contiene) que representa a un �ngulo en radianes y devuelve el seno de ese �ngulo.

SPACE (numero)

Recibe como argumento un n�mero (o variable que lo contiene) y devuelve una cadena formada por espacios en blanco; tantos como especifica el n�mero.

SQR (n�mero)

Devuelve la ra�z cuadrada del n�mero (o variable num�rica) que recibe como argumento.

STRCOMP (cadena 1, cadena 2)

Recibe como argumentos dos cadenas alfanum�ricas (o variables que las contienen) separadas por comas. Si ambas cadenas son iguales devuelve un 0. Si la primera es mayor que la segunda, devuelve un 1. Si la segunda es mayor que la primera devuelve un -1. Si alguna cadena tiene un valor Null, devuelve Null. En este sentido debemos recordar que un car�cter es mayor o menor que otro en funci�n de sus c�digos ASCII. As�, p.e., la a es mayor que la A, porque el c�digo ASCII de la A es 65 y el de la a es 97.

STRING (n�mero, car�cter)

Recibe como argumentos un n�mero (o variable que lo contiene) y un car�cter (o variable que lo contiene). Devuelve una cadena compuesta por el car�cter especificado, repetido las veces que indica el n�mero.

STRREVERSE (cadena)

Recibe como argumento una cadena (o variable que la contiene) y devuelve la cadena tras invertir el orden de todos los caracteres que la componen. As� pues, el primero de la cadena original ser� el �ltimo de la cadena resultante.

TAN (n�mero)

Recibe un n�mero (o variable que lo contiene) que representa a un �ngulo en radianes y devuelve la tangente de ese �ngulo.

TIME ()

Esta funci�n no recibe ning�n argumento y devuelve una expresi�n que representa la hora del sistema en formato hh:mm:ss.

TIMESERIAL (n�mero 1, n�mero 2, n�mero 3)

Esta funci�n recibe tres par�metros num�ricos y los convierte a una hora en formato hh:mm:ss. El n�mero 1 debe estar comprendido entre 0 y 23; el n�mero 2 debe estar comprendido entre 0 y 59 y el n�mero 3 tambi�n.

TIMEVALUE (fecha)

Esta funci�n recibe una variable de fecha y extrae y devuelve la parte de la hora.

TRIM (cadena)

Recibe como argumento una cadena o variable que la contiene. Devuelve la cadena sin los espacios en blanco que hay a la izquierda y a la derecha de la misma.

TYPENAME (variable)

Esta funci�n recibe un nombre de variable y devuelve el nombre de subtipo del dato que contiene.

UCASE (cadena)

Recibe como argumento una cadena (o una variable que contiene una cadena) y la convierte a may�sculas.

WEEKDAY (fecha, primer_d�a)

Esta funci�n recibe dos par�metros. Es primero es una fecha o variable que la contiene; el segundo es una constante que indica el que es el primer d�a de la semana en nuestro pa�s. Devuelve un n�mero correspondiente al d�a de la semana de la fecha introducida. Las constantes para identificar que d�a de la semana es el primero en nuestro pa�s son:

WEEKDAYNAME (d�a_semana, abreviado, primer_dia)

Esta funci�n recibe un n�mero de d�a de la semana, un valor l�gico y una constante que indica cual es el primer d�a de la semana en nuestro pa�s. Devuelve como resultado el nombre del d�a de la semana que corresponde al n�mero introducido. Si el valor l�gico es verdadero, el nombre que devuelve aparece en abreviatura. Las constantes que identifican el d�a de la semana son las mismas que en el caso anterior.