Captulo 5 - Funciones propias de Visual Basic Volver al ndice

En esta quinta parte del tutorial de Visual Basic se describen las funciones propias del lenguaje que permiten trabajar con cadenas de caracteres, con nmeros, fechas, horas, presentar mensajes en pantalla y muchas otras funciones para formatar datos especficos.

Contenido

y 1 - Funciones para el tratamiento de cadenas

y 1.1 - Funcin Lcase y Ucase

y 1.2 - Funcin Trim, LTrim y RTrim

y 1.3 - Funcin Len

y 1.4 - Funcin Asc y Chr

y 1.5 - Funcin InsTr

y 1.6 - Funcin Left, Right y Mid

y 1.7 - Funcin Str y Val

y 2 - Funciones para el tratamiento de nmeros

y 2.1 - Funcin Round

y 2.2 - Rnd y Randomize - Nmeros aleatorios

y 2.3 - Otras funciones

y 3 - Funciones de formato

y 4 - Funciones de formato para fechas y hora

y 4.1 - Funciones para calcular fechas

y 4.2 - Funciones para obtener la fecha y hora de la PC

y 6 - Funciones para presentar mensajes - InputBox y

MSgbox

y 7 - Ejemplos

1 - Funciones para el tratamiento de cadenas Las funciones de cadena , como su nombre lo indica, se utilizan para trabajar y tratar las cadenas de caracteres. A continuacin las mas importantes de ellas.

1.1 - Funcin Lcase y Ucase Estas dos funciones se utilizan para convertir cadenas de texto a minscula y mayscula. La funcin Lcase cambia o convierte una cadena de texto a minscula y un ejemplo de como utilizarla sera as:

Lcase (cadena que queremos convertir a minsculas)

Ejemplo:

Dim cadena As String cadena = "HOLA MUNDO" 'Convertimos cadena = LCase(cadena) 'La variable cadena ahora vale "hola mundo"

La funcin Ucase funciona de la misma manera que Lcase pero convierte el contenido de una cadena a maysculas. Por ejemplo, si tenemos un control Label1 que contiene un texto que dice: "Porcentaje de sueldos", escribiendo la siguiente lnea:

Label1 = UCase(Label1)

El control Label1 pasara a mostrar o mejor dicho contener en su propiedad caption:"PORCENTAJE DE SUELDOS".

1.2 - Funcin Trim, LTrim y RTrim Estas tres funciones se utilizan para eliminar los espacios vacos de una cadena. LTrim elimina los espacios vacos de la parte izquierda de la cadena, RTrim de la parte derecha y Trim de ambas partes. Ejemplos: Tenemos una variable llamada ciudad con el valor " Barcelona". Para eliminar los espacios vacos de la izquierda haramos lo siguiente:

ciudad = LTrim(ciudad)

Si en un TextBox quisieramos borrar todos los espacios vacos de la parte derecha de la cadena:

MiText = RTrim(MiText)

La Funcin Trim elimina todos los espacios vacos de ambos lados de la cadena. Ejemplo:

Pais = " Argentina Pas = Trim(Pais)

"

Ahora el valor de Pas es igual a: "Argentina".

1.3 - Funcin Len La funcin Len nos permite conocer la cantidad de caracteres que tiene una determinada cadena. O sea que esta funcin nos devuelve un nmero. Ejemplo:

Len (Aqu va la cadena que queremos averiguar su tamao)

Como la funcin Len devuelve un nmero debemos asignar ese nmero devuelto en una variable de tipo numrica.

Ejemplo:

Dim TamanoCadena As Long Dim MiCadena As String MiCadena = "Me Llamo Eustaquio" TamanoCadena = Len(MiCadena)

El valor de la variable TamanoCadena pasara a valer 18. Hay que tener en cuenta que la funcin Len tambin toma en cuenta los espacios vacos.

1.4 - Funcin Asc y Chr La funcin Asc nos permite obtener el cdigo ASCII de un de terminado caracter. Ejempos: Si queremos obtener el cdigo ASCII del caracter "a", que es el nmero 97 podramos hacer lo siguiente:

Dim num As Integer num = Asc("a") En definitiva la funcin Asc lleva un solo parmetro de tipo String del cual queremos obtener dicho nmero. La Funcin Chr acta a la inversa de la funcin Asc, esto quiere decir, que a partir de un determinado nmero nos devolver el caracter ASCII.

Obviamente que en vez de pasarle a la funcin un parmetro String es decir la letra, debemos pasarle un nmero ASCII y nos devolver el carcter asociado. Ejemplo:

Dim letra As String letra = Chr(97) La variable pasa a valer en este caso el caracter "a"

1.5 - Funcin InsTr La funcin InStr se utiliza para buscar una cadena o parte de una cadena dentro de otra cadena. Si la funcin encuentra la cadena a buscar devuelve un nmero que representa la posicin donde encontr la cadena, si no la encuentra devuelve un 0. Los parmetros que lleva esta funcin son:

InStr (comienzo, Cadena donde buscar , La Cadena a buscar) Como esta funcin devuelve un nmero debemos almacenarla en una variable de tipo numrica para utilizarla. Ejemplo:

Dim posicion As Integer posicion = InStr("Estoy tomando mate", "mate") En este ejemplo la funcin encontr la cadena "mate" en la posicin 15, o sea que la variable posicin pasa a valer 15.

Si observamos bien, la funcin en el primer parmetro, denominado comienzo, nos pide que le digamos desde que posicin comenzar a buscar. En nuestro ejemplo, este parmetro lo obviamos, esto quiere decir que comenzar desde la posicin 0 de la cadena a buscar. Pero podramos especificar una posicin en particular, por ejemplo desde la 5 , 10 etc..., segn lo que necesitemos hacer.

Otro ejemplo de InsTr : Este ejemplo, muestra como buscar dentro de un control TextBox, el cual tiene dos opciones, un botn para buscar la primera frase, y otro que sigue buscando a partir de donde est ubicda la seleccin. Para armar el ejemplo colocar un Textbox llamado Text_Buscar que es donde se ingresar la frase y otro TextBox llamado Text1 que tendr el texto. Este ultimo con la propiedad Multiline en True. Tambin colocar dos CommandButton: Command1 y Command2

Colocar el siguiente cdigo fuente en el formulario:

Option Explicit

Private m_Pos As Integer

Sub buscar_cadena(ByVal Posicion As Integer)

Dim p As Integer, Frase As String

Frase = txt_Buscar

p = InStr(Posicion, Text1, Frase)

If p > 0 Then m_Pos = p

With Text1 .SelStart = m_Pos - 1 .SelLength = Len(Frase) .SetFocus End With Else

MsgBox "No se encontr la frase", vbInformation Text1.SetFocus End If End Sub

Private Sub Command1_Click() 'Busca a pratir de la primera pocicin Call buscar_cadena(1) End Sub

Private Sub Command2_Click() 'Busca a partir del valor que tenga m_Pos

Call buscar_cadena(m_Pos + 1)

End Sub

Private Sub Form_Load() Command1.Caption = "Buscar" Command2.Caption = "Buscar siguiente" Me.Caption = "Ejemplo de InStr " End Sub

Nota: tambin hay una funcin similar a Instr llamada InstrRev , y lo que hace es devolver la posicin de la primera concurrencia de una cadena dentro de otra cadena, pero comenzando por el extremo derecho de la misma En este enlace hay un ejemplo que usa la funcin instrRev Extraer de un path o ruta, solo la extensin del archivo

Funcin Left, Right y Mid

Estas funciones son utilizadas para extraer partes de una cadena. La funcin Left: tiene 2 parmetros: El primero es la cadena de la cual se extraern caracteres, y el segundo un nmero desde el cual comenzar a extraer caracteres desde la parte izquierda. Ejemplo:

Dim Cadena As String Cadena = Left("Ya es la madrugada", 9) 'Cadena, que es un string, sera igual a: "Ya es la"

Funcin Right: Es igual que la funcin Left pero comienza a extraer caracteres desde el lado derecho de la cadena. La funcin Mid: Tiene la misma funcin que las anteriores pero posee tres parmetros. Su sintaxis es:

Mid (cadena, inicio, longitud) El parmetro cadena es la cadena a extraer caracteres. El parmetro Inicio es donde comenzar y el parmetro longitud, es la cantidad de caracteres a extraer de la cadena de caracteres Ejemplos:

Dim nombre As String nombre = Mid("River perdi la copa", 7, 6) 'La variable nombre sera igual a: "perdi"

Este Otro ejemplo usa la funcin Mid para realizar un simple efecto tipo mquina de escribir. Colocar en un formulario un CommandButton y el siguiente cdigo fuente en el form.

Option Explicit

Sub Pausa(Segundos As Double)

Dim inicio As Double

' Devuelve la cantidad de segundos desde que inicio windows inicio = Timer

Do While (Timer - inicio) < Segundos ' pausa DoEvents Loop End Sub

Private Sub Command1_Click()

Dim texto As String

texto = "... Hola mundo --->>> "

Call MostrarTexto(texto, 0.1, Me)

End Sub

Private Sub MostrarTexto(Frase As String, _ Segundos As Double, _ Destino As Object)

Dim LenFrase As Integer Dim i As Integer

Dim Caracter As String Dim texto As String

LenFrase = Len(Frase)

Do While i <= LenFrase Destino.Cls

DoEvents i = i + 1 ' Obtiene el siguiente caracter Caracter = Mid(Frase, i, 1) ' texto actual texto = texto & Caracter Destino.Print texto ' Imprimi e/ dibuja el texto ' pausa o delay Pausa Segundos DoEvents Loop End Sub

Private Sub Form_Load()

Me.FontSize = 12 Me.Font.Bold = True Me.ForeColor = vbRed Command1.Caption = " Efecto de texto con mid " End Sub

Private Sub Form_Unload(Cancel As Integer) End End Sub

1.6 - Funcin Str y Val

La funcin Val convierte una cadena en un nmero yla funcin Str un nmero en una cadena. Ejemplos:

cadena = "123456" cadena = Val(cadena) 'Ahora cadena vale 123456 cadena2 = 123456 cadena2 = Str(cadena2) 'Ahora cadena2 vale "123456"

2 - Funciones para el tratamiento de nmeros Visual Basic posee muchas funciones para tratar nmeros. A continuacin las principales funciones.

2.1 - Funcin Round La funcin Round se utiliza para redondear un nmero decimal, devolviendo un nmero entero. Ejemplo:

Dim Mimumero As Long Minumero = Round(245.8) '(La funcin devuelve 246) Minumero = Round(245.3) '(La funcin devuelve 245) Minumero = Round(245.5) '(La funcin devuelve 245) Round posee un parmetro opcional por si queremos incluir los dgitos decimales.

2.2 - Rnd y Randomize - Nmeros aleatorios Para generar nmeros aleatorios, Visual Basic incluye 2 funciones: Rnd y Randomize. La funcin Rnd devuelve un nmero aleatorio, y esta posee un solo parmetro. Ejemplo :

Rnd (nmero)

Pero para poder generar dichos nmeros aleatorios, debemos utilizar previamente la funcin Randomize con la siguiente frmula:

Dim LimiteInferior As Integer Dim LimiteSuperior As Integer LimiteInferior = 20 LimiteSuperior = 40 MsgBox Int((LimiteInferior LimiteSuperior + 1) * Rnd + LimiteInferior) En el ejemplo anterior, se generarn nmeros aleatorios comprendidos entre el 20 y el 40 Nota: en este enlace pods ver un ejemplo que permite generar nmeros aleatorios no repetidos

Funciones matemticas Las principales funciones matemticas provistas por Visual Basic son:

y Abs: Devuelve el valor absoluto de una expresin numrica.

y Atn: Devuelve el arco tangente de un nmero.

y Cos: Devuelve el coseno de un ngulo.

y Exp: Devuelve el nmero "e" elevado a una potencia.

y Log: Devuelve el logaritmo natural de un nmero.

y Sgn: Devuelve un valor indicando el signo de un nmero.

y Sin: Devuelve el seno de un ngulo.

y Sqr: Devuelve la raz cuadrada de un nmero.

y Tan: Devuelve la tangente de un ngulo.

3 - Funciones de formato Visual Basic posee varias funciones para darle formato a distintos tipos de datos e informacin. A continuacin se ve algunos ejemplos de las principales funciones:

y FormatCurrency: Esta funcin se utiliza para trabajar con

nmeros con formato en dinero. Ejemplo:

si tenemos un nmero 3 y utilizamos la funcin nos devolvera

"$3".

y FormatPercent: Esta funcin es utilizada para trabajar con

porcentajes. Ejemplo :

si tendramos un nmero 321, nos devolvera: "32,1%" .

y FormatDateTime: Esta funcin trabaja con fechas y horas.

y FormatNumber: Formatea expresiones nmeros

Resultado = Resultado = Resultado = devolvera:

FormatPercent(321) 'devuelve: "32.100,00%" FormatCurrency(3) 'devuelve: "$3,00" FormatDateTime("6-8-1978") 'La funcin "06/08/1978"

NumDigitsAfterDecimal: Parmetro de tipo opcional. Este indicar cuantos nmeros decimales devolver la funcin: Ejemplo

cadena = FormatCurrency(325, 3) 'Devuelve: "$325,000"

Ejemplo de la funcin FormatDateTime

Esta funcin, en el primer parmetro se le debe pasar la fecha u hora a formatear, y el segundo parmetro es el tipo de formato, pueden ser 5 tipos. vbGeneralDate, vbLongDate, vbShortDate, vbLongTime y vbShortTime. Este parmetro es de tipo opcional. al colocar la coma dentro de la funcin , visual basic despliega la lista de constanetas mencionadas, como muestra el grfico:

Un ejemplo para ver estos formatos utilizando FormatDateTime: Colocar cinco option Button, cada botn de opcin mostrar los diferentes formatos en el caption del formulario, es decir en la barra de ttulo.

Cdigo en el formulario:

Private Sub Form_Load()

Option1.Caption = " vbGeneralDate " Option2.Caption = " vbLongDate " Option3.Caption = " vbShortDate " Option4.Caption = " vbLongTime " Option5.Caption = " vbShortTime "

End Sub Private Sub Option1_Click() Me.Caption = FormatDateTime(Now, vbGeneralDate) End Sub

Private Sub Option2_Click() Me.Caption = FormatDateTime(Now, vbLongDate) End Sub

Private Sub Option3_Click() Me.Caption = FormatDateTime(Now, vbShortDate) End Sub

Private Sub Option4_Click() Me.Caption = FormatDateTime(Now, vbLongTime) End Sub

Private Sub Option5_Click() Me.Caption = FormatDateTime(Now, vbShortTime) End Sub

FormatNumber - Ejemplos:

Formatea 0.489698 a 0,49

Dim Numero As Double Numero = 0.489698 Numero = FormatNumber(Numero, 2, vbFalse) MsgBox Numero Formatea 1.958754 a 1,96

Dim Numero As Double Numero = 1.958754 Numero = FormatNumber(Numero, 2) MsgBox Numero

Funcin Format:

La funcin Format es mas completa que las anteriores funciones, porque puede manejar mas tipos de datos, y no devuelve solo cadenas, esta tambin puede devolver nmeros y fechas. La funcin Format posee dos parmetros:

Format (Expresin, formato)

En el primero debemos colocar cualquier expresin vlida. El segundo es opcional y a continuacin veremos una descripcin de los formatos de VB:

y GeneralNumber: Devuelve el nmero sin formato.

y Currency: Devuelve el nmero en formato moneda, con el

smbolo "$" y 2 decimales a las derecha.

y Fixed: Devuelve como mnimo un dgito a la izquierda y 2 ala

derecha del decimal.

y Standar: Similar a Fixed pero incluye un separador de miles.

y Percent: Multiplica el nmero por cien y le agrega el smbolo "%"

y True/False: Devuelve Verdadero para un valor distinto de 0,y

Falso para 0.

y On/OFF: Devuelve "Activado" para un valor distinto de 0, y

"Desactivado" para 0. La forma de pasar el parmetro es entre comillas. Ejemplo:

cadena = Format(75, "Currency") ' Devolvera: "$75,00"

Nota: Si ingresamos un nmero decimal, debemos utilizar el "." y no la coma "," ya que la coma determina el comienzo de otro parmetro dentro de la funcin y Visual basic dara error de sintaxis

4 - Funciones de formato para fechas y hora

Ejemplos de los principales Formatos con nombre para el manejo de Fechas y Horas:

Funciones para Fechas

Dim cadena As String cadena = Format("06/08/78", "General Date") ' Devuelve: "06/08/1978" cadena = Format("19/08/79", "Long Date") ' Devuelve : "Jueves 19 de Agosto de 1979". cadena = Format("19/8/79", "Medium Date") ' Devuelve: "19Ago-1979" cadena = Format("17:08", "Short Time") ' "05:08" cadena = Format("17:08", "Medium Time") ' "05:08 PM" cadena = Format("17:08", "Long Time") ' "05:08:00 PM"

4.1 - Funciones para calcular fechas Visual basic cuenta con una serie de funciones que nos permiten calcular fechas y horas, por ejemplo generar un intervalo de fechas, sumar y restar fechas y horas y otras operaciones y clculos DateAdd : Devuelve un Variant que contiene una fecha que indica el intervalo de tiempo que se ha agregado DateDiff : Devuelve el nmero de intervalos de tiempo entre dos fechas determinadas DatePart : Devuelve una parte especfica de una fecha dada DateSerial : Devuelve un valor Date para un ao, mes y da determinados

Ejemplos El siguiente ejemplo utiliza la funcin DateDiff para mostrar el itervalo entre dos fechas. El intervalo lo muestra en segundos , minutos, dias, semanas meses y aos, como muestra el siguiente grfico

Colocar en el formulario un Command1.

Option Explicit

' recibe las dos fechas como parmetros ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ''''''''' Private Sub Calcular(Fecha_Inicial As Date, _ Fecha_Final As Date)

Const Formato As String = "#,##0"

Me.Cls Me.Print "Calcular Intervalos entre las fechas Fecha_Inicial & _ " &

" hasta :" & Fecha_Final & vbNewLine & String(150, "-") & vbNewLine

Me.Print Format(DateDiff("s", Fecha_Inicial, Fecha_Final), Formato) & " segundos" Me.Print Format(DateDiff("n", Fecha_Inicial, Fecha_Final), Formato) & " minutos" Me.Print Format(DateDiff("h", Fecha_Inicial, Fecha_Final), Formato) & " horas"

Me.Print Format(DateDiff("y", Fecha_Inicial, Fecha_Final), Formato) & " dias" Me.Print Format(DateDiff("WW", Fecha_Inicial, Fecha_Final), Formato) & " semanas" Me.Print Format(DateDiff("m", Fecha_Inicial, Fecha_Final), Formato) & " meses" Me.Print Format(DateDiff("yyyy", Fecha_Inicial, Fecha_Final), Formato) & " aos"

End Sub

Private Sub Command1_Click() ' le pasa las dos fechas a la funcin Call Calcular("01/01/2000", Date) End Sub

Private Sub Form_Load()

Me.AutoRedraw = True Command1.Caption = "calcular intervalos "

End Sub

Ejemplo con DateAdd Lo siguiente, muestra como aadir y restar fechas

' agrega 10 aos a la fecha actual MsgBox DateAdd("yyyy", 10, Date)

' Agrega cinco meses a la fecha actual MsgBox DateAdd("m", 5, Date)

' resta 1 dias a la fecha actual ( usa el signo -) MsgBox DateAdd("y", -1, Date)

Nota: para restar, usar el signo negativo, como se usa en el ltimo ejemplo. Para poder restar y agregar segundos a una hora, usar en el parmetro intervalo la "S", para minutos usar la "n", para horas la "h", para restar y sumar semanas la "ww"

En el siguiente enlace pods ver algunos otros ejemplos que trabajan con dichas funciones Funciones para trabajar con fechas en visual basic Calcular edad de una persona usando DateDiff Averiguar con Dateserial, el Primer y ltimo da de un mes 4.2 - Funciones para obtener la fecha u hora actual de la PC

Dim Cadena As String Cadena = Date ' Devuelve el da del sistema en este formato: "02/08/2004" Cadena = Time ' Devuelve la hora del sistema en este formato: "17:32:51" 'Funciones para establecer la fecha u hora de la PC: Date = (La fecha que queremos establecer) Time = (La hora que queremos establecer)

5 - Funciones para presentar mensajes

Visual Basic posee 2 tipos de funciones para presentar mensajes, ellas son MsgBox e InputBox.

Funcin InputBox: La funcin InputBox presenta un mensaje al usuario, permitindole ingresar un valor en una caja de texto:

Como se dijo la funcin InputBox presenta un cuadro de dilogo donde el usuario puede ingresar un texto y luego aceptar o cancelar dicho cuadro de dilogo. Los parmetros principales de esta funcin son:

InputBox (Promt,Title, Default)

y El parmetro Prompt especfica la leyenda que mostrar la caja de

mensajes.

y El parmetro Title especifica el ttulo que llevar el cuadro de

dilogo.

y El parmetro Default es el texto que mostrar la caja de texto.

El aspecto mas importante de InputBox es que nos devuelve una cadena con lo que haya ingresado el usuario en la caja de texto. Luego podemos realizar una tarea especfica dependiendo del valor devuelto. Ejemplo:

Dim retorno As String retorno = InputBox("Ingrese algo en la caja de texto", "Ejemplo") MsgBox "Usted ingres:" & retorno

En el ejemplo anterior, en la variable Retorno se almacenar el valor que haya ingresado el usuario cuando haga Click en el botn de Aceptar. Cuando el usuario presiona Candelar, el InputBox devuelve una cadena vaca. Esto es importante tenerlo en cuenta para realizar una o tal accin Si quiseramos por ejemplo desplegar un InputBox, y que este no se cierre hasta que el usuario si o si haya ingresado un valor, podemos hacerlo de la siguiente forma, utilizando una condicin en un bucle Do Loop

Cdigo fuente en el formulario

Private Sub Form_Load()

Dim Dato As String

' Hasta que no se ingrese un dato, _ el InputBox no se cerrar Do Dato = InputBox("Ingresar algun dato", " Ejemplo ") Loop Until Dato <> ""

'Muestra el valor MsgBox Dato, vbInformation

End Sub

Enlace relacionado : InputBox con PasswordChar

Funcin MsgBox:

La funcin MsgBox, que ya se vi varias veces en distintos ejemplos, es muy fcil de usar y se utiliza para mostrar distintos tipos de mensajes. Ejemplos de mensajes o cajas de texto con la funcin MsgBox que podemos mostrar:

Como se ve en los grficos anteriores, con MsgBox podemos tener variedad a la hora de mostrar un determinado mensaje, utilizando para ello las diferentes constantes que incorpora la funcin. Los parmetros mas importantes son:

y Title : Es la leyenda que aparecer en el ttulo del mensaje.

y Texto : Es el Texto que mostrar el mensaje.

y Botones: En este parmetro se colocan las constantes que

determinarn si la caja tiene uno o varios botones y el tipo de

mensaje: informativo, de exclamacin de alerta etc... Cuando

escribimos la coma dentro de la funcin en el parmetro botones,

Visual Basic despliega una lista con las opciones o constantes que

podemos utilizar.

Enlaces sobre MsgBox Como crear MsgBox con imagenes e conos personalizados Ejemplo para cambiar el texto de los botones de un MsgBox

6 - Ejemplos para descargar

1. Ejemplo que muestra como utilizar la funcin Ucase y Lcase para convertir un texto a mayscula o minscula. 2. Ejemplo muy simple que utiliza las funciones LTrim, RTrim y Trim para eliminar espacios vacos en una cadena de texto 3. Ejemplo que utiliza la funcin Chr para mostrar en un control label la tecla que presionemos, utilizando el evento keypress del formulario. 4. Este ejemplo muestra como podemos localizar una cadena de texto dentro de otra utilizando la funcin InsTr 5. Muestra un ejemplo de como usar las funciones Left y Right para extraer partes de una cadena a partir de otra cadena. 6. Ejemplo para ver las funciones Randomize y Rnd , para generar nmeros aleatorios, a partir de un valor mnimo y un valor mximo. 7. Ejemplo sencillo que muestra como utilizar la funcin FormatCurrency, FormatPercent y FormatDatetime.

8. Programa de ejemplo que utiliza la funcin Date para establecer la fecha del sistema 9. Muestra como utilizar un mensaje de informacin en caso de que ocurra un error en tiempo de ejecucin, utilizando la sentencia GoTo 10. Ejemplo que muestra como utilizar un mensaje con dos botones y ejecutar una instruccin determinada de a acuerdo a una estructura If-ThenElse

Volver al men del tutorial