Professional Documents
Culture Documents
Contenido
Funciones matemticas....................................................................................................................... 2
Funciones matemticas derivadas ...................................................................................................... 2
Abs (Funcin)....................................................................................................................................... 4
Atn (Funcin) ....................................................................................................................................... 4
Asc (Funcin) ....................................................................................................................................... 5
Chr (Funcin) ....................................................................................................................................... 5
Cos (Funcin) ....................................................................................................................................... 6
Date (Funcin) ..................................................................................................................................... 6
DateAdd (Funcin) .............................................................................................................................. 6
DateSerial (Funcin) ............................................................................................................................ 8
DateValue (Funcin) ............................................................................................................................ 9
Day (Funcin) ...................................................................................................................................... 9
Exp (Funcin) ....................................................................................................................................... 9
Hour (Funcin) .................................................................................................................................. 10
InputBox (Funcin) ............................................................................................................................ 10
InStr (Funcin) ................................................................................................................................... 12
InStrRev (Funcin) ............................................................................................................................. 13
Int, Fix (Funciones) ............................................................................................................................ 14
IsDate (Funcin) ................................................................................................................................ 15
IsEmpty (Funcin).............................................................................................................................. 15
IsNumeric (Funcin) .......................................................................................................................... 16
LCase (Funcin) ................................................................................................................................. 17
Left (Funcin) .................................................................................................................................... 17
Len (Funcin) ..................................................................................................................................... 18
LoadPicture (Funcin) ....................................................................................................................... 19
Log (Funcin) ..................................................................................................................................... 21
LTrim, Rtrim y Trim (Funciones) ........................................................................................................ 22
Mid (Funcin) .................................................................................................................................... 23
Minute (Funcin) ............................................................................................................................... 24
Month (Funcin)................................................................................................................................ 24
MonthName (Funcin) ...................................................................................................................... 25
MsgBox (Funcin) .............................................................................................................................. 25
Now (Funcin) ................................................................................................................................... 28
QBColor (Funcin) ............................................................................................................................. 28
Replace (Funcin) .............................................................................................................................. 29
RGB (Funcin) .................................................................................................................................... 30
Right (Funcin) .................................................................................................................................. 31
Rnd (Funcin) .................................................................................................................................... 31
Randomize (Instruccin) ................................................................................................................... 32
Round (Funcin) ................................................................................................................................ 33
Second (Funcin) ............................................................................................................................... 33
Sgn (Funcin) ..................................................................................................................................... 33
Funciones matemticas
Abs (Funcin)
Atn (Funcin)
Cos (Funcin)
Exp (Funcin)
Fix (Funcin)
Int (Funcin)
Log (Funcin)
Rnd (Funcin)
Sgn (Funcin)
Sin (Funcin)
Sqr (Funcin)
Tan (Funcin)
Derivadas equivalentes
Sec(X) = 1 / Cos(X)
Cosec(X) = 1 / Sin(X)
Cotan(X) = 1 / Tan(X)
Seno inverso
Coseno inverso
Secante inversa
Cosecante inversa
Cotangente inversa
Seno hiperblico
Coseno hiperblico
Tangente hiperblica
Secante hiperblica
Cosecante hiperblica
Cotangente hiperblica
Seno hiperblico inverso
Coseno hiperblico inverso
Tangente hiperblica inversa
Secante hiperblica inversa
Cosecante
hiperblica
inversa
Cotangente
hiperblica
inversa
Logaritmo en base
Abs (Funcin)
Devuelve un valor del mismo tipo que el que se pas como parmetro y que especifica el valor
absoluto de un nmero.
Sintaxis
Abs(nmero)
Elargumento nmero puede ser cualquierexpresin numrica vlida. Si nmero contieneNull, la
funcin devolver Null; si es unavariable no inicializada, devolver cero.
Comentarios
El valor absoluto de un nmero es su magnitud sin signo. Por ejemplo, ABS(-1) y ABS(1)
devuelven 1.
Ejemplos
Dim MiNmero
MiNmero = Asc("A")
MiNmero = Asc("a")
Atn (Funcin)
Devuelve un tipo Double que especifica el arcotangente de un nmero.
Sintaxis
Atn(nmero)
Elargumento nmero es un tipoDouble o cualquierexpresin numrica vlida.
Comentarios
La funcin Atn toma la razn de dos lados de un tringulo rectngulo (nmero) y devuelve el
ngulo correspondiente en radianes. La razn es la longitud del lado opuesto al ngulo dividida por
la longitud del lado adyacente al ngulo.
El ngulo del resultado es -pi/2 a pi/2 radianes.
Para convertir grados en radianes, multiplique los grados por PI/180. Para convertir radianes en
grados, multiplique los radianes por 180/pi.
Nota
Ejemplo
Dim pi
pi = 4 * Atn(1) ' Calcula el valor de pi.
Asc (Funcin)
Devuelve un tipoInteger que representa elcdigo de carcter correspondiente a la primera letra de
una cadena.
Sintaxis
Asc(cadena)
Elargumento obligatorio cadena es unaexpresin de cadena vlida. Si cadena no contiene caracteres,
se produce unerror en tiempo de ejecucin.
Comentarios
El intervalo del valor de retorno es entre 0 y 255 en sistemas que no sean DBCS, y entre 32768 y
32767 en sistemasDBCS.
Nota
La funcin AscB se utiliza con bytes de datos contenidos en una cadena. En lugar de
devolver el cdigo de carcter para el primer carcter, AscB devuelve el primer byte. La
funcin AscW siempre devuelve el cdigo de carcterUnicode en plataformas donde no se
admite Unicode, en cuyo caso, el comportamiento es idntico al de la funcin Asc.
Ejemplos
En este ejemplo se utiliza la funcin Asc para devolver el cdigo de carcter correspondiente a la
primera letra de una cadena de caracteres.
Dim MiNmero
MiNmero = Asc("A")
MiNmero = Asc("a")
Chr (Funcin)
Devuelve un tipoString que contiene el carcter asociado con elcdigo de carcter especificado.
Sintaxis
Chr(cdigocar)
Elargumento cdigocar es un tipoLong que identifica a un carcter.
Comentarios
Los nmeros del 0 al 31 son los mismos que los cdigosASCII estndar no imprimibles. Por
ejemplo, Chr(10) devuelve un carcter de avance de lnea. El intervalo normal de cdigocar es 0
255. Sin embargo, en sistemasDBCS, el intervalo real de cdigocar es de -32768 a 65535.
Nota
La funcin ChrB se utiliza con datos de byte incluidos en un tipo String. En lugar de
devolver un carcter, que puede ser de uno o de dos bytes, ChrB siempre devuelve un nico
byte. La funcin ChrW devuelve un tipo String que contiene el carcterUnicode excepto en
plataformas donde no se admite Unicode, en cuyo caso, el comportamiento es idntico al de
la funcin Chr.
Ejemplos
Dim MiCar
Cos (Funcin)
Devuelve un tipo Double que especifica el coseno de un ngulo.
Sintaxis
Cos(nmero)
Elargumento nmero es un tipoDouble o cualquierexpresin numrica vlida que expresa un ngulo
en radianes.
Comentarios
La funcin Cos toma un ngulo y devuelve la razn de dos lados de un tringulo rectngulo. La
razn es la longitud del lado adyacente al ngulo dividida por la longitud de la hipotenusa.
El resultado est dentro del intervalo -1 a 1.
Para convertir grados en radianes, multiplique los grados porpi/180. Para convertir radianes en
grados, multiplique los radianes por 180/pi.
Ejemplo
Dim Mingulo, MiSecante
Mingulo = 1.3 ' Define el ngulo en radianes.
MiSecante = 1 / Cos(Mingulo) ' Calcula la secante.
Date (Funcin)
Devuelve un tipo Variant (Date) que contiene la fecha actual del sistema.
Sintaxis
Date
Comentarios
Utilice la instruccin Date para establecer la fecha del sistema.
Ejemplo
Dim MiFecha
MiFecha = Date ' MiFecha contiene la fecha del sistema actual.
DateAdd (Funcin)
Devuelve un valor de tipo Variant (Date) con una fecha a la que se ha agregado un intervalo de
tiempo especificado.
Sintaxis
fecha
Requerido.
Valores
El argumento intervalo tiene los siguientes valores:
Valor
yyyy
q
m
y
d
w
ww
h
n
s
Descripcin
Ao
Trimestre
Mes
Da del ao
Da
Da de la semana
Semana
Hora
Minuto
Segundo
Comentarios
Puede utilizar la funcin DateAdd para agregar o restar un intervalo de tiempo especificado de una
fecha. Por ejemplo, con DateAdd podra calcular una fecha 30 das posterior al da de hoy o una
hora 45 minutos posterior a la actual.
Si desea agregar das a fecha, puede utilizar Da del ao ("y"), Da ("d") o Da de la semana ("w").
La funcin DateAdd no devuelve nunca una fecha no vlida. En el ejemplo siguiente se agrega un
mes al 31 de enero:
DateAdd("m", 1, "31-ene-95")
En este caso, DateAdd devuelve 28-feb-95 y no 31-feb-95. Si fecha es 31-ene-96, devolver 29-feb96, ya que 1996 es un ao bisiesto.
Si la fecha calculada va a resultar inferior al ao 100 (esto es, se restan ms aos que los que hay en
fecha), se produce un error.
Si nmero no es un valor de tipoLong se redondear al nmero entero ms cercano antes de ser
evaluado.
Nota El formato del valor devuelto por DateAdd es determinado por la configuracin del Panel de
DateSerial (Funcin)
Devuelve un tipo Variant (Date) para un ao, mes y da especificados.
Sintaxis
Descripcin
ao
mes
da
Comentarios
Para especificar una fecha, como el 31 de diciembre de 1991, el intervalo de nmeros para
cadaargumento de DateSerial debera estar en el intervalo normalmente aceptado para la unidad; es
decir, 131 para das y 112 para meses. Sin embargo, puede especificar fechas relativas para cada
argumento, usando cualquier expresin numrica que represente algn nmero de das, meses o
aos, antes o despus de cierta fecha.
El ejemplo siguiente usa expresiones numricas en lugar de nmeros de fecha absoluta. Aqu la
funcin DateSerial devuelve una fecha que es el da antes del primer da del mes (1 - 1), dos meses
antes de agosto (8 - 2), 10 aos antes de 1990 (1990 - 10); en otras palabras, el 31 de mayo de 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Para el argumento ao, los valores entre 0 y 29, inclusive, se interpretan como los aos 20002029.
Los valores entre 30 y 99, se interpretan como los aos 19301999.Para el resto de los argumentos
ao se usa un ao con los cuatro dgitos (por ejemplo, 1800).
Cuando un argumento no est incluido en el intervalo aceptado normalmente para l, se incrementa
hasta la siguiente unidad mayor, segn convenga. Por ejemplo, si especifica 35 das, se evala como
un mes y algunos das, dependiendo de la parte del ao donde se aplique. No obstante, si un solo
argumento est fuera de su intervalo -32.768 a 32.767 o si la fecha especificada por los tres
argumentos, directamente o mediante expresin, no se incluye en el intervalo aceptable de fechas,
se produce un error.
Ejemplo
Dim MiFecha
' MiFecha contiene la fecha correspondiente al 12 de
' febrero de 1969.
MiFecha = DateSerial(1969, 2, 12) ' Devuelve una fecha.
DateValue (Funcin)
Devuelve un tipo Variant (Date).
Sintaxis
DateValue(fecha)
Elargumento fecha es normalmente unaexpresin de tipo cadena (String) que representa una fecha
del 1 de enero del ao 100, al 31 de diciembre de 9999. Sin embargo, fecha tambin puede ser
cualquierexpresin que pueda representar una fecha, una hora o una fecha y una hora en ese
intervalo.
Comentarios
Si fecha es una cadena que incluye solamente nmeros separados porseparadores de fecha,
DateValue reconoce el orden para mes, da y ao de acuerdo al formato de Fecha abreviado que se
haya especificado para el sistema. DateValue tambin reconoce fechas claramente definidas que
contengan nombres de mes, en forma completa o abreviada. Por ejemplo, adems de reconocer
30/12/1991 y 30/12/91, DateValue tambin reconoce 30 de diciembre de 1991 y dic 31, 1991.
Si se omite la parte de ao de fecha, DateValue usa el ao actual de la fecha del sistema de su PC.
Si el argumento fecha incluye informacin de hora, DateValue no la devuelve. Sin embargo, si
fecha incluye informacin de hora no vlida (tal como "89:98"), ocurrir un error.
Ejemplo
Dim MiFecha
MiFecha = DateValue("12 de febrero de 1969")
' Devuelve una fecha.
Day (Funcin)
Devuelve el valor de tipo Variant (Integer) que especifica un nmero entero entre 1 y 31, inclusive,
que representa el da del mes.
Sintaxis
Day(fecha)
Elargumento fecha es cualquier valor de tipoVariant,expresinnumrica,cadena, o cualquier
combinacin que pueda representar una fecha. Si fecha contieneNull, la funcin devolver Null.
Ejemplo
Dim MiFecha, MiDa
MiFecha = #12 febrero 1969#
MiDa = Day(MiFecha)
Exp (Funcin)
Devuelve un tipo Double que especifica e (la base de los logaritmos naturales) elevado a una
potencia.
Sintaxis
Exp(nmero)
Elargumento nmero es un tipoDouble o cualquierexpresin numrica vlida
Comentarios
Si el valor de nmero es mayor que 709.782712893, se produce un error. El valor de laconstante e
es 2.718282 aproximadamente.
Nota
Ejemplo
Dim Mingulo, MiSenoH
' Define el ngulo en radianes.
Mingulo = 1.3
' Calcula el seno hiperblico.
MiSenoH = (Exp(Mingulo) - Exp(-1 * Mingulo)) / 2
Hour (Funcin)
Devuelve un valor de tipo Variant (Integer) que especifica un nmero entero entre 0 y 23, inclusive,
que representa la hora del da.
Sintaxis
Hour(hora)
Elargumento hora puede ser un valor de tipoVariant, unaexpresin numrica,expresin de tipo
cadena o cualquier combinacin, que pueda representar una hora. Si hora contieneNull, la funcin
devolver Null.
Ejemplo
Dim MiTiempo, MiHora
MiTiempo = #4:35:17 PM# ' Asigna una hora.
MiHora = Hour(MiTiempo) ' MiHora contiene 16.
InputBox (Funcin)
Muestra un mensaje en un cuadro de dilogo, espera que el usuario escriba un texto o haga clic en
un botn y devuelve un tipoString con el contenido del cuadro de texto.
Sintaxis
Descripcin
prompt
title
default
xpos
ypos
helpfile
context
Comentarios
Cuando se especifica tanto helpfile como context, el usuario puede presionar F1 para ver el tema de
Ayuda correspondiente a context. Algunasaplicaciones host, por ejemplo, Microsoft Excel, tambin
agregar automticamente un botn Ayuda al cuadro de dilogo. Si el usuario hace clic en Aceptar o
presiona Entrar , la funcin InputBox devuelve lo que haya en el cuadro de texto. Si el usuario hace
clic en Cancelar, la funcin devuelve una cadena de caracteres de longitud cero ("").
Nota
Si desea especificar ms que el primer argumento con nombre, debe utilizar InputBox en
unaexpresin. Si desea omitir algunosargumentos de posicin, debe incluir el delimitador
de coma correspondiente.
Ejemplos
En este ejemplo se muestran distintas maneras de utilizar la funcin InputBox para indicar al
usuario que debe introducir un valor. Si se omiten las posiciones x e y, el dilogo se centra
automticamente segn los ejes respectivos. La variable MyValue contiene el valor introducido por
el usuario, si ste hace clic sobre Aceptar o presiona ENTER. Si el usuario hace clic sobre Cancelar,
se devuelve una cadena de caracteres de longitud cero.
Dim Mensaje, Ttulo, ValorPred, MiValor
Mensaje = " Introduzca un nmero del 1 a 3" ' Establece el mensaje.
Ttulo = "Demostracin de InputBox" ' Establece el ttulo.
ValorPred = "1" ' Establece el valor predeterminado.
' Muestra el mensaje, el ttulo, y el valor predeterminado.
InStr (Funcin)
Devuelve un tipo Variant (Long) que especifica la posicin de la primera aparicin de una cadena
en otra.
Sintaxis
string1
string2
compare
Descripcin
Opcional.Expresin numrica que establece la posicin inicial para cada bsqueda. Si
se omite, la bsqueda comienza en la posicin del primer carcter. Si inicio contiene
un valorNull, se produce un error. El argumento inicio se requiere si se especifica
compare.
Requerido.Expresin de cadena en la que se busca.
Requerido. Expresin de cadena buscada.
Opcional. Especifica el tipo decomparacin de cadena. Si se omite compare, el valor
Option Compare determina el tipo de comparacin.
Valores
Los valores del argumento compare son:
Constante
vbUseCompareOption
vbBinaryCompare
vbTextCompare
vbDatabaseCompare
Valor Descripcin
1
Realiza una comparacin con los valores de la instruccin Option
Compare.
0
Realiza una comparacin binaria.
1
Realiza una comparacin textual.
2
Slo para Microsoft Access. Realiza una comparacin basada en
la informacin en las bases de datos.
Valores devueltos
Si
string1 es de longitud cero
string1 es Null
string2 es de longitud cero
string2 es Null
string2 no se encontr
0
string2 se encontr dentro de string1 Posicin en la que se halla la coincidencia
start > string2
0
Comentarios
La funcin InStrB se utiliza con los datos de byte contenidos en una cadena. En lugar de devolver la
posicin del carcter de la primera aparicin de una cadena en otra, InStrB devuelve la posicin del
byte.
Ejemplo
En este ejemplo se utiliza la funcin InStr para devolver la posicin de la primera ocurrencia de una
cadena en otra.
Dim SearchString, SearchChar, MyPos
SearchString ="XXpXXpXXPXXP" ' Cadena en la que se busca.
SearchChar = "P"
InStrRev (Funcin)
Descripcin
Devuelve la posicin de una aparicin de una cadena dentro de otra, desde el final de la cadena.
Sintaxis
comparar
Valores
Descripcin
Requerido.Expresin de cadena en la que se busca.
Requerido. Expresin de cadena que se busca.
Opcional. Unaexpresin nmerica que establece la posicin inicial para cada bsqueda.
Si se omite, se utiliza 1, que significa que la bsqueda empieza en la posicin del
ltimo carcter. Si el inicio contiene Nulo, se produce un error.
Opcional. Un valor numrico que indica la clase de comparacin que se utilizar
cuando se evalen subcadenas. Si se omite, se realiza una comparacin binaria. Vea la
seccin Valores para consultar los valores posibles.
vbBinaryCompare
vbTextCompare
vbDatabaseCompare
Valor Descripcin
1
Realizar una comparacin utilizando el valor de la instruccin
Option Compare.
0
Realizar una comparacin binaria.
1
Realiza una comparacin basada en el texto.
2
Slo para Microsoft Access. Realizar una comparacin basada en
la informacin de su base de datos.
Valores de retorno
InStrRev
Si I
cadena1 es de longitud cero
cadena1 es Null
cadena2 es de longitud cero
cadena2 es Null
cadena2 no se encuentra
cadena2 se encuentra dentro de cadena1
inicio > Len(cadena2)
Comentarios
Observe que la sintaxis para la funcin InstrRev no es la misma que la sintaxis para la funcin Instr.
Int(nmero)
Fix(nmero)
El argumento nmero es un tipo Double o cualquier expresin numrica vlida. Si nmero contiene
Null, la funcin devolver Null.
Comentarios
Las funciones Int y Fix eliminan la fraccin de un nmero y devuelven el valor entero resultante.
La diferencia entre Int y Fix es que si el nmero es negativo, Int devuelve el primer entero negativo
menor o igual a nmero, mientras que Fix devuelve el primer entero negativo mayor o igual a
nmero. Por ejemplo, Int convierte -8.4 en -9 y Fix convierte -8.4 a -8.
La funcin Fix(nmero) es equivalente a:
Sgn(nmero) * Int(Abs(nmero))
Ejemplo
Este ejemplo muestra cmo las funciones Int y Fix devuelven la parte entera de los nmeros. En el
caso de que el argumento sea un nmero negativo, la funcin Int devuelve el primer nmero entero
negativo menor o igual que el nmero; la funcin Fix devuelve el primer entero negativo mayor o
igual que el nmero.
Dim MiNmero
MiNmero = Int(99.8) ' Devuelve 99.
MiNmero = Fix(99.2) ' Devuelve 99.
MiNmero = Int(-99.8) ' Devuelve -100.
MiNmero = Fix(-99.8) ' Devuelve -99.
MiNmero = Int(-99.2) ' Devuelve -100.
MiNmero = Fix(-99.2) ' Devuelve -99.
IsDate (Funcin)
Devuelve un valor de tipo Boolean que indica si unaexpresin se puede convertir en una fecha.
Sintaxis
IsDate(expresin)
Elargumento expresin requerido, es un tipo de datosVariant que contiene unaexpresin de fecha o
unaexpresin de cadena reconocible como una fecha o una hora.
Comentarios
La funcin IsDate devuelve True si la expresin es una fecha o se puede reconocer como una fecha
vlida; en caso contrario, devuelve False. En Microsoft Windows, el intervalo de fechas vlidas va
desde el 1 de enero de 100 D. de C. hasta el 31 de diciembre de 9999 D.de C.; los intervalos varan
de un sistema operativo a otro.
Ejemplo
Dim MiFecha, TuFecha, SinFecha, MiPrueba
MiFecha = "12 febrero 1969": TuFecha = #2/12/69#: SinFecha = "Hola"
MiPrueba = IsDate(MiFecha)
MiPrueba = IsDate(TuFecha)
MiPrueba = IsDate(SinFecha)
IsEmpty (Funcin)
Devuelve un valor de tipo Boolean que indica si unavariable ha sido inicializada.
Sintaxis
IsEmpty(expresin)
El argumento expresin requerido es un tipo de datos Variant que contiene una expresin de cadena
o una expresin numrica. Sin embargo, ya que la funcin IsEmpty se utiliza para determinar si las
variables individuales estn inicializadas, el argumento expresin es generalmente un nico nombre
de variable.
Comentarios
La funcin IsEmpty devuelve True si la variable no est inicializada o est explcitamente
configurada a Empty; en cualquier otro caso, devuelve False. Se devuelve False siempre que
expresin contenga ms de una variable. La funcin IsEmpty solamente devuelve informacin
significativa para datos de tipo Variant.
Ejemplo
Dim MiVar, MiPrueba
MiPrueba = IsEmpty(MiVar) ' Devuelve True.
MiVar = Null ' Asigna Null.
MiPrueba = IsEmpty(MiVar) ' Devuelve False.
MiVar = Empty ' Asigna Empty.
MiPrueba = IsEmpty(MiVar) ' Devuelve True.
IsNumeric (Funcin)
Devuelve un valor de tipo Boolean que indica si unaexpresin se puede evaluar como un nmero.
Sintaxis
IsNumeric(expresin)
Elargumento expresin requerido, es un tipo de datosVariant que contiene unaexpresin numrica o
unaexpresin de tipo cadena.
Comentarios
La funcin IsNumeric devuelve True si la expresin completa se reconoce como un nmero; en otro
caso, devuelve False.
La funcin IsNumeric devuelve False si expresin es unaexpresin de fecha.
Ejemplo
Dim MiVar, MiPrueba
MiVar = "53"
LCase (Funcin)
Devuelve un tipoString que se ha convertido a minsculas.
Sintaxis
LCase(cadena)
Elargumento cadena es cualquierexpresin de cadena vlida. Si string contieneNull, se devuelve
Null.
Comentarios
Slo se convierten a minsculas las letras maysculas. Las letras minsculas o los caracteres que no
son letras no sufren cambios.
Ejemplo
Dim UpperCase, LowerCase
Uppercase = "Hola Mundo 1234" ' Cadena a convertir.
Lowercase = Lcase(UpperCase)
Left (Funcin)
Devuelve un tipo Variant (String) que contiene un nmero especificado de caracteres del lado
izquierdo de una cadena.
Sintaxis
Left(string, length)
La sintaxis de la funcin Left tiene estosargumentos con nombre:
Parte
string
Descripcin
Requerido.Expresin de cadena de la cual se devuelven los caracteres que estn ms a la
izquierda. Si string contieneNull, se devuelve Null.
length Requerido, un tipo Variant (Long).Expresin numrica que indica cuntos caracteres se
van a devolver. Si es 0, devuelve una cadena de longitud cero (""). Si es mayor o igual al
nmero de caracteres en string, se devuelve la cadena entera.
Comentarios
Para determinar el nmero de caracteres en string, utilice la funcin Len.
Nota Utilice la funcin LeftB con datos de byte contenidos en una cadena. En lugar de especificar
el nmero de caracteres que se van a devolver, length especifica el nmero de bytes.
Ejemplo
Dim UnaCadena, MiCadena
UnaCadena = "Hola Mundo"
Len (Funcin)
Devuelve un tipoLong que contiene el nmero de caracteres en una cadena o el nmero de bytes
necesarios para almacenar unavariable.
Sintaxis
Len(cadena | nombrevar)
La sintaxis de la funcin Len consta de las siguientes partes:
Parte
Descripcin
cadena
Cualquierexpresin de cadena vlida. Si cadena contieneNull, se devuelve Null.
Nombrevar Cualquier nombre devariable vlido. Si nombrevar contiene Null, se devuelve Null. Si
nombrevar es un tipoVariant, Len acta igual que con un tipo String y siempre
devuelve el nmero de caracteres que contiene.
Comentarios
Se deben especificar uno (y slo uno) de los dosargumentos posibles. Contipos definidos por el
usuario, Len devuelve el tamao como se escribir en el archivo.
Nota Utilice la funcin LenB con datos de byte incluidos en una cadena, como en los lenguajes del
conjunto de caracteres de doble byte (DBCS). En lugar de devolver el nmero de caracteres
en una cadena, LenB devuelve el nmero de bytes utilizados para representar esa cadena.
Con tipos de datos definidos por el usuario, LenB devuelve el tamao en memoria,
incluyendo cualquier relleno entre cdigo que utiliza LenB, vea el segundo ejemplo en el
tema de ejemplo.
Nota
Puede que Len no sea capaz de determinar el nmero real requerido de bytes de
almacenamiento cuando se utiliza con cadenas de longitud variable entipos de
datosdefinidos por el usuario.
Ejemplo
En este ejemplo se utiliza la funcin Len para devolver el nmero de caracteres en una cadena o el
nmero de bytes requeridos para almacenar una variable. El bloque Type...End Type que define
RegistroCliente debe ir precedido por la palabra clave Private si aparece en un mdulo de clase. En
un mdulo estndar, una instruccin Type puede ser Public.
Type RegistroCliente
ID As Integer
MiLong = Len(MiEntero)
' Devuelve 2.
MiLong = Len(Customer)
MiLong = Len(MiCadena)
MiLong = Len(MyCur)
' Devuelve 8.
Este segundo ejemplo utiliza LenB y una funcin definida por el usuario (LenMbcs) para devolver
el nmero de carcteres byte en una cadena si se utiliza ANSI para representar la cadena.
Function LenMbcs (ByVal str as String)
LenMbcs = LenB(StrConv(str, vbFromUnicode))
End Function
Dim MiCadena, MyLen
MiCadena = "ABc"
' Donde "A" y "B" son DBCS y "c" es SBCS.
MyLen = Len(MyString)
' Devuelve 3 - 3 caracteres en la cadena.
MyLen = LenB(MyString)
' Devuelve 6 - 6 bytes en Unicode.
MyLen = LenMbcs(MiCadena)
' Devuelve 5 - 5 bytes en ANSI.
LoadPicture (Funcin)
Carga un grfico en un objeto Picture, un control PictureBox o un control Image.
Sintaxis
Descripcin
Opcional. Expresin de cadena que indica un nombre de archivo. Puede incluir
carpetas y unidades. Si no se indica un nombre de archivo LoadPicture borra el
control Image o PictureBox.
tamao
Tipo Variant opcional. Si nombreArchivo es un cursor o un archivo de icono,
indica el tamao de imagen deseado.
profundidadColor Tipo Variant opcional. Si nombreArchivo es un archivo de cursor o icono,
indica la profundidad de color deseada.
Valores
Los valores para tamao son:
Constante
vbLPSmall
vbLPLarge
vbLPSmallShell
Valor
0
1
2
vbLPLargeShell 3
vbLPCustom
Descripcin
Icono pequeo del sistema.
Icono grande del sistema, determinado por el controlador de vdeo.
Tamao del icono pequeo de Ayuda, determinado por el tamao
establecido para los ttulos de los botones en la ficha Apariencia en el
cuadro de dilogo Propiedades de la pantalla del Panel de control.
Tamao del icono grande de Ayuda, determinado por la ficha
Apariencia en el cuadro de dilogo Propiedades de la pantalla del Panel
de control.
Tamao predeterminado, valores proporcionados por los argumentos x e
y
Valor
0
1
2
3
Descripcin
Mejor coincidencia si se usa el archivo especificado.
2 colores.
16 colores.
256 colores.
Comentarios
Los formatos grficos reconocidos por Visual Basic incluyen archivos de mapas de bits (.bmp),
archivos de iconos (.ico), archivos de cursor (.cur), archivos de longitud codificada (.rle),
metarchivos (.wmf), metarchivos mejorados (.emf), archivos GIF (.gif) y archivos JPEG (.jpg).
Es posible limpiar los grficos de formularios, cuadros de imagen y controles de imagen si asigna
LoadPicture sin argumentos.
Para cargar grficos para presentarlos en un control PictureBox, en un control Image o como fondo
de un formulario, el valor devuelto por LoadPicture debe asignarse a la propiedad Picture del objeto
en el que se quiere presentar la imagen. Por ejemplo:
Set Picture = LoadPicture("FIESTA.BMP")
Set Image1.Picture = LoadPicture("FIESTA.BMP")
Para asignar un icono a un formulario, establezca el valor devuelto por la funcin LoadPicture a la
propiedad Icon del objeto Form:
Log (Funcin)
Devuelve un tipo Double que especifica el logaritmo natural de un nmero.
Sintaxis
Log(nmero)
Elargumento nmero es un tipoDouble o cualquierexpresin numrica vlida mayor que cero.
Comentarios
El logaritmo natural es el logaritmo en base e. El valor de laconstante e es 2.718282
aproximadamente.
Puede calcular logaritmos en base-n para cualquier nmero x dividiendo el logaritmo natural de x
por el logaritmo natural de n de la siguiente manera:
Logn(x) = Log(x) / Log(n)
El ejemplo siguiente ilustra una funcin personalizada (Function) que calcula logaritmos en base
10:
Static Function Log10(X)
Log10 = Log(X) / Log(10#)
End Function
Ejemplo
Dim Mingulo, MiLog
' Define el ngulo en radianes.
Mingulo = 1.3
' Calcula el seno hiperblico inverso.
MiLog = Log(Mingulo + Raz(Mingulo * Mingulo + 1))
LTrim(cadena)
RTrim(cadena)
Trim(cadena)
El argumento cadena obligatorio es cualquier expresin de cadena vlida. Si cadena contieneNull,
se devuelve Null.
Ejemplo
Dim MiCadena, CadenaCorte
MiCadena = " <-Cortar-> " ' Inicializa la cadena.
CadenaCorte = LTrim(MiCadena) ' CadenaCorte = "<-Cortar-> ".
CadenaCorte = RTrim(MiCadena) ' CadenaCorte = " <-Cortar->".
Mid (Funcin)
Devuelve un tipo Variant (String) que contiene un nmero especificado de caracteres de una
cadena.
Sintaxis
Descripcin
Requerido.Expresin de cadena de la cual se devuelven los caracteres. Si string
contieneNull, se devuelve Null.
start
Requerido; un tipoLong. Posicin de carcter en string en la cual comienza la parte que se
quiere tomar. Si start es mayor que el nmero de caracteres en la string, Mid devuelve una
cadena de longitud cero ("").
length Requerido; un tipo Variant (Long). Nmero de caracteres que se van a devolver. Si se
omite o en el texto hay menos de length caracteres (incluyendo el carcter de start), se
devuelven todos los caracteres desde la posicin de start hasta el final de la cadena.
Comentarios
Para determinar el nmero de caracteres en string, utilice la funcin Len.
Nota Utilice la funcin MidB con datos de byte incluidos en una cadena, como en los lenguajes de
conjunto de caracteres de doble byte. En lugar de especificar el nmero de caracteres,
losargumentos especifican el nmero de bytes. Para ver cdigo de ejemplo que utiliza
MidB, vea el segundo ejemplo en el tema de ejemplo.
Ejemplo
En este ejemplo se utiliza la funcin Mid para devolver un nmero especificado de caracteres de
una cadena.
Dim MiCadena, PrimeraPalabra, UltimaPalabra, PalabraMedia
MiCadena = "Demostracin funcin Mid" ' Crea la cadena de texto.
PrimeraPalabra = Mid(MiCadena, 1, 12) ' Devuelve "Demostracin".
UltimaPalabra = Mid(MiCadena, 21, 3) ' Devuelve "Mid".
PalabraMedia = Mid(MiCadena, 14) ' Devuelve "funcin Mid".
Este segundo ejemplo utiliza MidB y una funcin definida por el usuario (MidMbcs) para devolver
tambin caracteres de una cadena. La diferencia en este ejemplo es que la cadena de entrada es
ANSI y la longitud en bytes.
Function MidMbcs(ByVal str as String, start, length)
Minute (Funcin)
Devuelve un valor de tipo Variant (Integer) que especifica un nmero entero entre 0 y 59, inclusive,
que representa el minuto de la hora.
Sintaxis
Minute(hora)
Elargumento hora es cualquier valor de tipoVariant, unaexpresin numrica,expresin de tipo
cadena o cualquier combinacin que pueda representar una hora. Si hora contieneNull, la funcin
devolver Null.
Ejemplo
En este ejemplo se utiliza la funcin Minute para obtener los minutos de una hora especificada. En
el entorno de desarrollo, el literal de hora se presentar en formato abreviado, utilizando la
configuracin regional del cdigo.
Dim MiTiempo, MiMinuto
MiTiempo = #4:35:17 PM# ' Asigna una hora.
MiMinuto = Minute(MiTiempo) ' MiMinuto contiene 35.
Month (Funcin)
Devuelve un valor de tipo Variant (Integer) que especifica un nmero entero entre 1 y 12, inclusive,
que representa el mes del ao.
Sintaxis
Month(fecha)
El argumento fecha es cualquier valor de tipo Variant, una expresin numrica, expresin de tipo
cadena o cualquier combinacin, que pueda representar una fecha. Si fecha contiene Null, la
funcin devolver Null.
Ejemplo
Dim MiFecha, MiMes
MiFecha = #12 febrero 1969# ' Asigna una fecha.
MiMes = Month(MiFecha) ' MiMes contiene 2.
MonthName (Funcin)
Devuelve una cadena que indica el mes especificado.
Sintaxis
MonthName(mes [, abreviar])
La sintaxis de la funcin MonthName consta de las siguientes partes:
Parte
mes
Descripcin
Requerido. La designacin numrica del mes. Por ejemplo, enero es 1, febrero es 2,
etctera.
abreviar Opcional. El valor Boolean que indica si se va a abreviar el nombre del mes. Si se omite,
el valor predeterminado es False, que significa que el nombre del mes no se abrevia.
MsgBox (Funcin)
Muestra un mensaje en un cuadro de dilogo, espera a que el usuario haga clic en un botn y
devuelve un tipo Integer correspondiente al botn elegido por el usuario.
Sintaxis
buttons
title
Descripcin
Requerido.Expresin de cadena que representa el prompt en el cuadro de dilogo. La
longitud mxima de prompt es de aproximadamente 1024 caracteres, segn el ancho de
los caracteres utilizados. Si prompt consta de ms de una lnea, puede separarlos
utilizando un carcter de retorno de carro (Chr(13)) o un carcter de avance de lnea
(Chr(10)), o una combinacin de caracteres de retorno de carro avance de lnea (Chr(13)
y Chr(10)) entre cada lnea y la siguiente.
Opcional.Expresin numrica que corresponde a la suma de los valores que especifican el
nmero y el tipo de los botones que se pretenden mostrar, el estilo de icono que se va a
utilizar, la identidad del botn predeterminado y la modalidad del cuadro de mensajes. Si
se omite este argumento, el valor predeterminado para buttons es 0.
Opcional. Expresin de cadena que se muestra en la barra de ttulo del cuadro de dilogo.
Si se omite title, en la barra de ttulo se coloca el nombre de la aplicacin.
helpfile Opcional. Expresin de cadena que identifica el archivo de Ayuda que se utiliza para
proporcionar ayuda interactiva en el cuadro de dilogo. Si se especifica helpfile, tambin
se debe especificar context.
context Opcional. Expresin numrica que es igual al nmero de contexto de Ayuda asignado por
el autor al tema de Ayuda correspondiente. Si se especifica context, tambin se debe
especificar helpfile.
Valores
El argumento buttons tiene estos valores:
Constante
VbOKOnly
VbOKCancel
VbAbortRetryIgnore
VbYesNoCancel
VbYesNo
VbRetryCancel
VbCritical
VbQuestion
VbExclamation
VbInformation
VbDefaultButton1
VbDefaultButton2
VbDefaultButton3
VbDefaultButton4
VbApplicationModal
Valor
0
1
2
3
4
5
16
32
48
64
0
256
512
768
0
Descripcin
Muestra solamente el botn Aceptar.
Muestra los botones Aceptar y Cancelar.
Muestra los botones Anular, Reintentar e Ignorar.
Muestra los botones S, No y Cancelar.
Muestra los botones S y No.
Muestra los botones Reintentar y Cancelar.
Muestra el icono de mensaje crtico.
Muestra el icono de pregunta de advertencia.
Muestra el icono de mensaje de advertencia.
Muestra el icono de mensaje de informacin.
El primer botn es el predeterminado.
El segundo botn es el predeterminado.
El tercer botn es el predeterminado.
El cuarto botn es el predeterminado.
Aplicacin modal; el usuario debe responder al cuadro de
mensajes antes de poder seguir trabajando en la aplicacin
actual.
VbSystemModal
4096
Sistema modal; se suspenden todas las aplicaciones hasta
que el usuario responda al cuadro de mensajes.
VbMsgBoxHelpButton
16384
Agrega el botn Ayuda al cuadro de mensaje.
VbMsgBoxSetForeground 65536
Especifica la ventana del cuadro de mensaje como la
ventana de primer plano.
VbMsgBoxRight
524288 El texto se alnea a la derecha.
VbMsgBoxRtlReading
1048576 Especifica que el texto debe aparecer para ser ledo de
derecha a izquierda en sistemas hebreo y rabe.
El primer grupo de valores (0 a 5) describe el nmero y el tipo de los botones mostrados en el
cuadro de dilogo; el segundo grupo (16, 32, 48, 64) describe el estilo del icono, el tercer grupo (0,
256, 512) determina el botn predeterminado y el cuarto grupo (0, 4096) determina la modalidad
del cuadro de mensajes. Cuando se suman nmeros para obtener el valor final del argumento
buttons, se utiliza solamente un nmero de cada grupo.
Nota
Estasconstantes las especifica Visual Basic for Applications. Por tanto, el nombre de las
mismas puede utilizarse en cualquier lugar del cdigo en vez de sus valores reales.
Valores devueltos
Constante
vbOK
vbCancel
vbAbort
vbRetry
vbIgnore
vbYes
vbNo
Valor
1
2
3
4
5
6
7
Descripcin
Aceptar
Cancelar
Anular
Reintentar
Ignorar
S
No
Comentarios
Cuando se proporcionan tanto helpfile como context, el usuario puede presionar F1 para ver el tema
de Ayuda correspondiente al context. Algunasaplicaciones host, por ejemplo Microsoft Excel,
tambin agregan automticamente un botn Ayuda al cuadro de dilogo.
Si el cuadro de dilogo cuenta con un botn Cancelar, presionar la tecla ESC tendr el mismo efecto
que hacer clic en este botn. Si el cuadro de dilogo contiene un botn Ayuda, se suministra ayuda
interactiva para ese cuadro de dilogo. Sin embargo, no se devuelve valor alguno hasta que se hace
clic en uno de estos botones.
Nota
Si desea especificar ms que el primer argumento con nombre, debe utilizar MsgBox en
unaexpresin. Si desea omitir algnargumento de posicin, debe incluir el delimitador de
coma correspondiente.
Ejemplo
En este ejemplo se utiliza la funcin MsgBox para mostrar un mensaje de error crtico en un cuadro
de dilogo con botones S y No. El botn No se considera la respuesta predeterminada. El valor
devuelto por la funcin MsgBox depende del botn elegido por el usuario. En este ejemplo, se
supone que DEMO.HLP es un archivo de Ayuda que contiene un tema con un nmero de contexto
igual a 1000.
Dim Mensaje, Estilo, Ttulo, Ayuda, Ctxt, Respuesta, MiCadena
Mensaje = "Desea continuar?" ' Define el mensaje.
Estilo = vbYesNo + vbCritical + vbDefaultButton2 ' Define los botones.
Ttulo = "Demostracin de MsgBox" ' Define el ttulo.
Ayuda = "DEMO.HLP" ' Define el archivo de ayuda.
Ctxt = 1000 ' Define el tema
' el contexto
' Muestra el mensaje.
Respuesta = MsgBox(Mensaje, Estilo, Ttulo, Ayuda, Ctxt)
If Respuesta = vbYes Then ' El usuario eligi el botn S.
MiCadena = "S" ' Ejecuta una accin.
Else ' El usuario eligi el botn No.
MiCadena = "No" ' Ejecuta una accin.
End If
Now (Funcin)
Devuelve un valor de tipo Variant (Date) que especifica la fecha y hora actuales de acuerdo con la
configuracin de la fecha y la hora del sistema de su equipo.
Sintaxis
Now
Ejemplo
Dim Hoy
Hoy = Now ' Obtiene la fecha y la hora del sistema actual.
QBColor (Funcin)
Devuelve un tipoLong que representa el cdigo de color RGB correspondiente al nmero de color
especificado.
Sintaxis
QBColor(color)
El argumento color es un nmero entero entre 0-15.
Valores
El argumento color toma los siguientes valores:
Nmero
0
1
2
3
4
5
6
7
Color
Negro
Azul
Verde
Aguamarina
Rojo
Fucsia
Amarillo
Blanco
Nmero
8
9
10
11
12
13
14
15
Color
Gris
Azul claro
Verde claro
Aguamarina claro
Rojo claro
Fucsia claro
Amarillo claro
Blanco brillante
Comentarios
El argumento color representa los valores de color que utilizan otras versiones de Basic (como
Microsoft Visual Basic para MS-DOS y Basic Compiler). Comenzando por el byte menos
significativo, el valor devuelto especifica los valores de rojo, verde y azul necesarios para establecer
el color correspondiente en el sistema RGB que utiliza Visual Basic para Aplicaciones.
Ejemplo
Este ejemplo utiliza la funcin QBColor para cambiar la propiedad BackColor del formulario
transferido como MiFormulario al color indicado por CdigoColor. QBColor acepta valores enteros
entre 0 y 15.
Replace (Funcin)
Devuelve una cadena en la que se reemplaz una subcadena especificada con otra subcadena un
nmero especificado de veces.
Sintaxis
comparar
Descripcin
Requerido. Unaexpresin de cadena que contiene la subcadena que reemplazar.
Requerido. La subcadena que se busca.
Requerido. La subcadena de sustitucin.
Opcional. La posicin dentro de la expresin donde se empezar a buscar la
subcadena. Si se omite, se supone que es 1.
Opcional. El nmero de sustituciones de subcadenas que se realizarn. Si se
omite, el valor predeterminado es 1, que significa que se hagan todas las
sustituciones posibles.
Opcional. El valor nmerico que indica la clase de comparacin que se realizar
cuando se evalen las subcadenas. Vea la seccin Valores para consultar los
valores posibles.
Valores
El argumento comparar puede tener los valores siguientes:
Constante
vbUseCompareOption
vbBinaryCompare
vbTextCompare
vbDatabaseCompare
Valor Descripcin
1
Realizar una comparacin utilizando el valor de la instruccin
Option Compare.
0
Realiza una comparacin binaria.
1
Realizar una comparacin basada en el texto.
2
Slo para Microsoft Access. Realizar una comparacin basada en
la informacin de su base de datos.
Valores de retorno
La funcin Replace devuelve los valores siguientes:
Si
expresin es de longitud cero
expresin es Null
encontrar es de longitud cero
reemplazarCon es de longitud
cero
Reemplazar devuelve
Una cadena de longitud cero ("").
Un error.
Una copia de expresin.
Una copia de expresin con todas las apariciones de encontrar
quitadas.
Comentarios
El valor de retorno de la funcin Replace es una cadena con sustituciones hechas que comienza en
la posicin especificada por inicio y concluye al final de la cadena expresin. No es una copia de la
cadena original desde el inicio al final.
RGB (Funcin)
Devuelve un nmero entero tipoLong que representa un valor de color RGB.
Sintaxis
Valor de rojo
0
0
0
0
255
255
255
255
Valor de verde
0
0
255
255
0
0
255
255
Valor de azul
0
255
0
255
0
255
0
255
Ejemplo
Este ejemplo muestra cmo se utiliza la funcin RGB para devolver un nmero entero que
representa un valor de color RGB. Se utiliza por aquellos mtodos y propiedades de aplicacin que
aceptan una especificacin de color. El objeto MiObjeto y su propiedad se utilizan slo como
Right (Funcin)
Devuelve un tipo Variant (String) que contiene un nmero especificado de caracteres del lado
derecho de una cadena.
Sintaxis
Right(string, lenght)
La sintaxis de la funcin Right tiene estosargumentos con nombre:
Parte
string
Descripcin
Requerido.Expresin de cadena desde la cual se devuelven los caracteres que estn ms a
la derecha. Si string contieneNull, se devuelve Null.
lenght Requerido, un tipo Variant (Long).Expresin numrica que indica cuntos caracteres se
van a devolver. Si es 0, se devuelve una cadena de longitud cero (""). Si es mayor o igual al
nmero de caracteres en string, se devuelve la cadena completa.
Comentarios
Para determinar el nmero de caracteres en string, utilice la funcin Len.
Nota Utilice la funcin RightB con datos de byte incluidos en una cadena. En lugar de especificar
el nmero de caracteres para devolver, longitud especifica el nmero de bytes.
Ejemplo
Dim UnaCadena, MiCadena
UnaCadena = "Hola Mundo"
Rnd (Funcin)
Devuelve un tipo Single que contiene un nmero aleatorio.
Sintaxis
Rnd[(nmero)]
Rnd genera
El mismo nmero todas las veces, utilizando nmero como valor desemilla.
El siguiente nmero aleatorio de la secuencia.
El nmero generado ms recientemente.
El siguiente nmero aleatorio de la secuencia
Comentarios
La funcin Rnd devuelve un valor menor que 1 pero mayor o igual que cero.
El valor de nmero determina cmo la funcin Rnd genera un nmero aleatorio:
Para cualquier valor de semilla inicial se genera la misma secuencia de nmeros. Esto es debido a
que cada llamada sucesiva a la funcin Rnd usar el nmero anterior como valor de semilla para el
siguiente nmero de la secuencia.
Antes de llamar a la funcin Rnd, utilice la instruccin Randomize sin argumento para inicializar el
generador de nmeros aleatorios con un valor de semilla basado en el reloj del sistema.
Para producir enteros aleatorios en un intervalo dado, use esta frmula:
Int((Lmite_superior - lmite_inferior + 1) * Rnd + lmite_inferior)
Aqu, lmite_superior es el nmero mayor del intervalo y lmite_inferior es el nmero menor del
intervalo.
Nota
Para repetir secuencias de nmeros aleatorios, llame a la funcin Rnd con un argumento
negativo antes de utilizar la funcin Randomize con un argumento numrico. Al utilizar la
instruccin Randomize con el mismo valor de nmero no se repite la secuencia anterior.
Ejemplo
En este ejemplo se utiliza la funcin Rnd para generar un valor entero aleatorio de 1 a 6.
Dim MiValor
MiValor = Int((6 * Rnd) + 1) ' Genera un valor aleatorio entre 1 y 6.
Randomize (Instruccin)
Inicializa el generador de nmeros aleatorios.
Sintaxis
Randomize [nmero]
Elargumento opcional nmero es un tipoVariant o cualquierexpresin numrica vlida.
Comentarios
La instruccin Randomize utiliza nmero para inicializar el generador de nmeros
aleatorios de la funcin Rnd y le asigna un nuevo valorde semilla. Si omite nmero, el valor
devuelto por el reloj del sistema se usa como el nuevo valor de semilla.
Si no utiliza la instruccin Randomize, la funcin Rnd (sin argumentos) utiliza el mismo
nmero como valor de semilla la primera vez que se la invoca, usando despus como valor
Ejemplo
Dim MiValor
Randomize
Round (Funcin)
Devuelve un nmero redondeado en el nmero especificado de lugares decimales.
Sintaxis
Round(expresin [, nmLugaresDecimales])
La sintaxis de la funcin Round consta de las siguientes partes:
Parte
Descripcin
expresin
Requirido. Laexpresin numrica que se redondea.
nmLugaresDecimales Opcional. Un nmero que indica cuntos lugares a la derecha del decimal
se incluyen en el redondeo. Si se omite, la funcin Round devuelve
enteros.
Second (Funcin)
Devuelve un valor de tipo Variant (Integer) que especifica un nmero entero entre 0 y 59, inclusive,
que representa un segundo.
Sintaxis
Second(hora)
El argumento hora es cualquier valor de tipo Variant, una expresin numrica, expresin de tipo
cadena o cualquier combinacin, que pueda representar una hora. Si hora contiene Null, la funcin
devolver Null.
Ejemplo
Dim MiTiempo, MiSegundo
MiTiempo = #4:35:17 PM# ' Asigna una hora.
MiSegundo = Second(MiTiempo) ' MiSegundo contiene 17.
Sgn (Funcin)
Devuelve un tipo Variant (Integer) que indica el signo de un nmero.
Sintaxis
Sgn(nmero)
El argumento nmero puede ser cualquier expresin numrica vlida.
Valores devueltos
Si nmero es Sgn
Mayor que cero
Igual a cero
Menor que cero -
devuelve
1
0
1
Comentarios
El signo del argumento nmero determina el valor devuelto por la funcin Sgn.
Ejemplo
Dim MiVar1, MiVar2, MiVar3, MiSigno
MiVar1 = 12: MiVar2 = -2.4: MiVar3 = 0
MiSigno = Sgn(MiVar1) ' Devuelve 1.
MiSigno = Sgn(MiVar2) ' Devuelve -1.
MiSigno = Sgn(MiVar3) ' Devuelve 0.
Sin (Funcin)
Devuelve un tipo Double que especifica el seno de un ngulo.
Sintaxis
Sin(nmero)
El argumento nmero es un tipo Double o cualquier expresin numrica vlida que expresa un
ngulo en radianes.
Comentarios
La funcin Sin toma un ngulo y devuelve la razn de dos lados de un tringulo rectngulo. La
razn es la longitud del lado opuesto al ngulo dividido por la longitud de la hipotenusa.
El resultado entra dentro del intervalo -1 a 1.
Para convertir grados en radianes, multiplique los grados porpi/180. Para convertir radianes en
grados, multiplique los radianes por 180/pi.
Ejemplo
Dim Mingulo, MiCosecante
Mingulo = 1.3 ' Define el ngulo en radianes.
MiCosecante = 1 / Sin(Mingulo) ' Calcula la cosecante.
Space (Funcin)
Devuelve un tipo Variant (String) que consiste en un nmero especificado de espacios.
Sintaxis
Space(nmero)
El argumento nmero es el nmero de espacios que se desea incluir en la cadena.
Comentarios
La funcin Space es til para dar formato a la salida y para borrar datos en cadenas de longitud fija.
Ejemplo
Dim MiCadena
' Devuelve una cadena con 10 espacios.
MiCadena = Space(10)
' Inserta 10 espacios entre 2 cadenas.
MiCadena = "Hola" & Space(10) & "Mundo"
Sqr (Funcin)
Devuelve un tipo Double que especifica la raz cuadrada de un nmero.
Sintaxis
Sqr(nmero)
El nmeroargumento es un tipoDouble o cualquierexpresin numrica vlida mayor o igual a cero.
Ejemplo
Dim MiRaz
MiRaz = Sqr(4) ' Devuelve 2.
MiRaz = Sqr(23) ' Devuelve 4.79583152331272.
MiRaz = Sqr(0) ' Devuelve 0.
MiRaz = Sqr(-4) ' Genera un error en tiempo de ejecucin.
Str (Funcin)
Devuelve en un tipo Variant (String) la representacin de cadena de un nmero.
Sintaxis
Str(nmero)
Elargumento nmero necesario es un tipoLong que contiene unaexpresin numrica vlida.
Comentarios
Cuando los nmeros se convierten a cadenas, siempre se reserva un espacio a la izquierda para el
signo del nmero. Si nmero es positivo, la cadena devuelta contiene un espacio a la izquierda y el
StrComp (Funcin)
Devuelve un tipo Variant (Integer) que indica el resultado de unacomparacin de cadena.
Sintaxis
Descripcin
Requerido. Cualquierexpresin de cadena vlida.
Requerido. Cualquier expresin de cadena vlida.
Opcional. Especifica el tipo de comparacin de cadena. Si elargumento compare esnulo
el valor de Option Compare determina el tipo de comparacin.
Valores
Los valores de la instruccin compare son los siguientes:
Constante
vbUseCompareOption
vbBinaryCompare
vbTextCompare
vbDatabaseCompare
Valor Descripcin
1
Realiza una comparacin con los valores de la instruccin Option
Compare.
0
Realiza una comparacin binaria.
1
Realiza una comparacin textual.
2
Slo para Microsoft Access. Realiza una comparacin basada en
la informacin en las bases de datos.
Valores devueltos
La funcin StrComp devuelve los siguientes valores:
Si La funcin
StrComp devuelve
string1 es menor que string2 - 1
string1 es igual a string2
0
1
Null
Ejemplo
Dim MiCadena1, MiCadena2, MiComp
MiCadena1 = "ABCD": MiCadena2 = "abcd" ' Define las variables.
MiComp = StrComp(MiCadena1, MiCadena2, 1)' Devuelve 0.
MiComp = StrComp(MiCadena1, MiCadena2, 0)' Devuelve -1.
MiComp = StrComp(MiCadena2, MiCadena1) ' Devuelve 1.
StrConv (Funcin)
Devuelve un tipo Variant (String) que se convierte como se especifica.
Sintaxis
Descripcin
vbUpperCase
vbLowerCase
vbProperCase
vbWide*
Valor
1
2
3
4*
vbNarrow*
8*
vbKatakana**
vbHiragana**
vbUnicode
16**
32**
64
vbFromUnicode 128
Estasconstantes estn especificadas por Visual Basic for Applications. Como resultado, se
pueden utilizar en cualquier parte de su cdigo en lugar de los valores reales. La mayora se
pueden combinar, por ejemplo, vbUpperCase + vbWide, excepto cuando se excluyen
mutuamente, por ejemplo, vbUnicode + vbFromUnicode. Las constantes vbWide,
vbNarrow, vbKatakana y vbHiragana originanerrores en tiempo de ejecucin cuando
utilizanconfiguraciones regionales donde no se aplican.
String (Funcin)
Devuelve un tipo Variant (String) que contiene una cadena de caracteres que se repite de la longitud
especificada.
Sintaxis
String(number, character)
La sintaxis de la funcin String tiene estosargumentos con nombre:
Parte
number
Descripcin
Requerido; un tipoLong. Longitud de la cadena devuelta. Si nmero contieneNull, se
devuelve Null.
character Requerido; un tipoVariant.Cdigo de carcter que especifica el carcter o laexpresin de
cadena cuyo primer carcter se utiliza para construir la cadena devuelta. Si character
contiene Null, se devuelve Null.
Comentarios
Si se especifica para character un nmero mayor que 255, String convierte el nmero en un cdigo
de carcter vlido utilizando la frmula:
character Mod 256
Ejemplo
Dim MiCadena
MiCadena = String(5, "*")
MiCadena = String(5, 42)
StrReverse (Funcin)
Descripcin
Devuelve una cadena en la que se invierte el orden de carcter de una cadena especificada.
Sintaxis
StrReverse(cadena1)
El argumento cadena1 es la cadena cuyos caracteres se invierten. Si cadena1 es una cadena de
longitud cero (""), se devuelve una cadena de longitud cero. Si es Null, se produce un error.
Tan (Funcin)
Devuelve un tipo Double que especifica la tangente de un ngulo.
Sintaxis
Tan(nmero)
Elargumento nmero es un tipoDouble o cualquierexpresin numrica vlida que expresa un ngulo
en radianes.
Comentarios
La funcin Tan toma un ngulo y devuelve la razn de dos lados de un tringulo rectngulo. La
razn es la longitud del lado opuesto al ngulo, dividida por la longitud del lado adyacente al
ngulo.
Para convertir grados en radianes, multiplique los grados porpi/180. Para convertir radianes en
grados, multiplique los radianes por 180/pi.
Ejemplo
Dim Mingulo, MyCotangente
Mingulo = 1.3 ' Define el ngulo en radianes.
MyCotangente = 1 / Tan(Mingulo) ' Calcula la cotangente.
Time (Funcin)
Devuelve un valor de tipo Variant (Date) indicando la hora actual del sistema.
Sintaxis
Time
Comentarios
Use la instruccin Time para establecer la hora del sistema.
Ejemplo
Dim MiTiempo
MiTiempo = Time ' Devuelve la hora del sistema actual.
Timer (Funcin)
Devuelve un tipo Single que representa el nmero de segundos transcurridos desde la medianoche.
Sintaxis
Timer
Comentarios
En Microsoft Windows la funcin Timer devuelve partes fraccionales de un segundo.
Ejemplo
En este ejemplo se utiliza la funcin Timer para detener la aplicacin. El ejemplo tambin utiliza
DoEvents para pasar el control a otros procesos durante la pausa.
Dim TiempoPausa, Inicio, Final, TiempoTotal
If (MsgBox("Presione S para parar 5 segundos", 4)) = vbYes Then
TiempoPausa = 5 ' Asigna hora de inicio.
Inicio = Timer ' Establece la hora de inicio.
Do While Timer < Inicio + TiempoPausa
DoEvents ' Cambia a otros procesos.
Loop
Final = Time ' Asigna hora de finalizacin.
TiempoTotal = Final - Inicio ' Calcula tiempo total.
MsgBox "Detenida durante " & TiempoTotal & " segundos"
Else
End
End If
TimeSerial (Funcin)
Devuelve un tipo Variant (Date) que contiene la hora actual para una hora, minuto y segundo
especficos.
Sintaxis
Descripcin
Requerido; Variant (Integer). Nmero entre 0 (12:00 a.m.) y 23 (11:00 p.m.), inclusive o
unaexpresin numrica.
minuto Requerido; Variant (Integer). Cualquier expresin numrica.
segundo Requerido; Variant (Integer). Cualquier expresin numrica.
Comentarios
Para especificar una hora, como 11:59:59, el intervalo de nmeros para cada argumento de
TimeSerial debera estar en el intervalo normalmente aceptado para la unidad; es decir, 023 para
horas y 059 para minutos y segundos. Sin embargo, puede especificar horas relativas para
cadaargumento, usando cualquier expresin numrica que represente algunas horas, minutos o
segundos antes o despus de cierta hora. El ejemplo siguiente usaexpresiones en lugar de nmeros
de hora absoluta. La funcin TimeSerial devuelve una hora que es 15 (-15) minutos menos que seis
horas antes del medioda (12 - 6), 5:45:00 a.m.
TimeSerial(12 - 6, -15, 0)
Cuando algn argumento supera el intervalo normalmente aceptado para l, se incrementa hasta la
siguiente unidad mayor. Por ejemplo, si especifica 75 minutos, se evala como una hora y 15
minutos. No obstante, si un solo argumento est fuera del intervalo -32.768 a 32.767 o si la hora
especificada por los tres argumentos, directamente o mediante expresin, hace que la fecha quede
fuera del intervalo aceptable de valores, se produce un error.
Ejemplo
Dim MiTiempo
MiTiempo = TimeSerial(16, 35, 17) ' MiTiempo contiene la hora
' correspondiente a 4:35:17 PM.
TimeValue (Funcin)
Devuelve un tipo Variant (Date) que contiene la hora.
Sintaxis
TimeValue(hora)
Elargumento hora es normalmente unaexpresin de tipo cadena que representa una hora desde las
0:00:00 (12:00:00 a.m.) a las 23:59:59 (11:59:59 p.m.), inclusive. Sin embargo, hora tambin puede
ser cualquierexpresin que pueda representar una hora en ese intervalo. Si hora contieneNull, la
funcin devolver Null.
Comentarios
Puede introducir horas vlidas usando un reloj de 12 horas o de 24 horas. Por ejemplo, "2:24 p.m."
y "14:24" son argumentos vlidos de hora.
Si el argumento hora contiene informacin de fecha, TimeValue no devuelve esta informacin. Sin
embargo, si hora incluye informacin no vlida de fecha, ocurrir un
Ejemplo
Dim MiHora
MiHora = TimeValue("4:35:17 PM") ' Devuelve la hora.
TypeName (Funcin)
Devuelve una cadena (String) que proporciona informacin acerca de unavariable.
Sintaxis
TypeName(nombrevariable)
La variable contiene
Un objeto cuyo tipo es tipoobjeto
Un valor byte
Un entero
Un entero largo
Un nmero de punto flotante de precisin simple
Un nmero de punto flotante de precisin doble
Un valor de moneda
Un valor decimal
Un valor fecha
Una cadena
Un valor booleano
Un valor de error
No inicializado
Datos no vlidos
Un objeto
Un objeto cuyo tipo es desconocido
Una variable de que no hace referencia a un objeto
Si nombrevariable es unamatriz, la cadena devuelta puede ser cualquiera de las posibles (o Variant)
con un parntesis vaco aadido. Por ejemplo, si nombrevariable es una matriz de nmeros enteros,
la funcin TypeName devuelve "Integer()".
Ejemplo
Declara variables.
Dim VarNull, MiTipo, VarCad As String, VarEnt As Integer, VarMon As Currency
Dim VarMatriz (1 To 5) As Integer
VarNull = Null
UCase (Funcin)
Devuelve un tipo Variant (String) que contiene una cadena especificada que se ha convertido a
maysculas.
Sintaxis
UCase(cadena)
Elargumento cadena necesario es cualquierexpresin de cadena vlida. Si cadena contieneNull, se
devuelve Null.
Comentarios
Slo se convierten a maysculas las letras minsculas. Las letras maysculas o los caracteres que no
son letras no sufren cambios.
Ejemplo
Dim LowerCase, UpperCase
LowerCase = "Hola Mundo 1234" ' Cadena a convertir.
UpperCase = UCase(LowerCase)
Val (Funcin)
Devuelve los nmeros contenidos en una cadena como un valor numrico del tipo adecuado.
Sintaxis
Val(cadena)
El argumento obligatorio cadena es cualquier expresin de cadena vlida.
Comentarios
La funcin Val deja de leer la cadena en el primer carcter que no puede reconocer como parte de
un nmero. Los smbolos y caracteres que se consideran a menudo parte de valores numricos,
como signos de moneda y comas, no se reconocen. Sin embargo, la funcin reconoce los prefijos de
base &O (para octal) y &H (para hexadecimal). Los espacios en blanco, los tabuladores y los
avances de lnea se eliminan del argumento.
Lo siguiente devuelve el valor 1615198:
Val("
VarType (Funcin)
Devuelve un entero (Integer) que indica el subtipo de unavariable.
Sintaxis
VarType(nombrevariable)
Elargumento nombrevariable requerido, es un tipoVariant que contiene cualquier variable excepto
una variable de untipo definido por el usuario.
Valores devueltos
Constante
vbEmpty
vbNull
vbInteger
vbLong
vbSingle
vbDouble
vbCurrency
vbDate
vbString
vbObject
vbError
vbBoolean
vbVariant
vbDataObject
vbDecimal
vbByte
vbUserDefinedType
vbArray
Valor
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
17
36
8192
Descripcin
Empty (no inicializado)
Null (datos no vlidos)
Entero
Entero largo
Un nmero de coma flotante de precisin simple
Un nmero de coma flotante de precisin doble
Valor de moneda
Valor de fecha
Cadena
Objeto
Valor de error
Valor booleano
Variant (utilizada solamente conmatrices de variantes)
Un objeto de acceso a datos
Valor decimal
Valor de byte
Variantes que contienen tipos definidos por el usuario
Matriz
Nota Estasconstantes estn especificadas por Visual Basic para aplicaciones. Los nombres se
puede utilizar en cualquier posicin en su cdigo en lugar de los valores actuales.
Comentarios
La funcin VarType nunca devuelve por s misma el valor para vbArray. Siempre se agrega a algn
otro valor para indicar una matriz de un tipo particular. La constante vbVariant solamente se
devuelve junto con vbArray para indicar que el argumento de la funcin VarType es una matriz del
tipo Variant. Por ejemplo, el valor devuelto por una matriz de enteros se calcula como vbInteger +
vbArray, o 8194. Si un objeto tiene unapropiedad predeterminada, VarType (objeto) devuelve el
tipo de la propiedad predeterminada del objeto.
Ejemplo
Weekday (Funcin)
Devuelve un valor de tipo Variant (Integer) que contiene un nmero entero que representa el da de
la semana.
Sintaxis
Weekday(fecha, [primerdasemana])
La sintaxis de la funcin Weekday consta de los siguientesargumentos con nombre:
Parte
fecha
Descripcin
Requerido.Variant,expresin numrica,expresin de tipo cadena o cualquier
combinacin que puede representar una fecha. Si fecha contieneNull, la funcin
devolver Null.
primerdasemana Opcional. Unaconstante que especifica el primer da de la semana. Si no se
especifica, se asume el valor vbSunday.
Valores
El argumento primerdasemana tiene estos valores:
Constante
vbUseSystem
vbSunday
vbMonday
vbTuesday
vbWednesday
vbThursday
vbFriday
vbSaturday
Valor
0
1
2
3
4
5
6
7
Descripcin
Utilice configuracin de la API de NLS.
Domingo (predeterminado)
Lunes
Martes
Mircoles
Jueves
Viernes
Sbado
Valores devueltos
La funcin Weekday puede devolver cualquiera de estos valores:
Constante
vbSunday
vbMonday
vbTuesday
vbWednesday
vbThursday
Valor
1
2
3
4
5
Descripcin
Domingo
Lunes
Martes
Mircoles
Jueves
vbFriday
vbSaturday
6
7
Viernes
Sbado
Ejemplo
Dim MiFecha, MiDaSemana
MiFecha = #12 febrero 1969#
WeekdayName (Funcin)
Devuelve una cadena que indica el da de la semana especificado.
Sintaxis
Descripcin
Requerido. La designacin numrica para el da de la semana. El valor
numrico de cada da depende de la configuracin del valor
primerDaDeLaSemana.
abreviar
Opcional. Un valor Boolean que indica si se abrevia el nombre del da de
la semana. Si se omite, el valor predeterminado es False, que significa
que el nombre del da de la semana no se abrevia.
primerDaDeLaSemana Opcional. Un valor numrico que indica el primer da de la semana. Vea
la seccin Valores para consultar los valores posibles.
Valores
El argumento primerDaDeLaSemana puede tener los valores siguientes:
Constante
vbUseSystem
vbSunday
vbMonday
vbTuesday
vbWednesday
vbThursday
vbFriday
vbSaturday
Valor
0
1
2
3
4
5
6
7
Descripcin
Utilizar la configuracin de la API National Language Support (NLS).
Domingo (predeterminado).
Lunes.
Martes.
Mircoles.
Jueves.
Viernes.
Sbado
.Year (Funcin)
Devuelve un valor de tipo Variant (Integer) que contiene un nmero entero que representa el ao.
Sintaxis
Year(fecha)
El argumento fecha es cualquier valor de tipo Variant, expresin numrica, expresin de tipo
cadena o cualquier combinacin que puede representar una fecha. Si fecha contiene Null, la funcin
devolver Null.
Ejemplo
Dim MiFecha, MiAo
MiFecha = #12 febrero 1969#' Asigna una fecha.
MiAo = Year(MiFecha) ' MiAo contiene 1969.