DateValue (Función, Visual Basic)
Actualización: noviembre 2007
Devuelve un valor Date que contiene información sobre la fecha representada por una cadena, con la información sobre la hora establecida en medianoche (00:00:00).
Public Function DateValue(ByVal StringDate As String) As DateTime
Parámetros
- StringDate
Obligatorio. Expresión String que representa un valor de fecha u hora desde las 00:00:00 del 1 de enero del año 1 hasta las 23:59:59 del 31 de diciembre de 9999.
Excepciones
Tipo de excepción |
Número de error |
Condición |
|---|---|---|
StringDate incluye información de hora no válida. |
Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, debe considerarse la posibilidad de sustituir dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.
Comentarios
Si StringDate sólo incluye números comprendido entre 1 y 12 separados mediante separadores de fecha válidos, DateValue reconoce el orden del mes, día y año de acuerdo con el formato corto de fecha especificado en el sistema . DateValue utiliza la configuración del calendario actual de la propiedad CurrentCulture de la clase CultureInfo incluida en el espacio de nombres System.Globalization. Los valores de CurrentCulture predeterminados están determinados por la configuración del Panel de control. Puede reemplazar el formato corto de fecha; para ello, defina la propiedad ShortDatePattern de la clase DateTimeFormatInfo incluida en el espacio de nombres System.Globalization.
DateValue reconoce nombres de mes en formato largo, abreviado y numérico. Por ejemplo, además de reconocer 30/12/1991 y 30/12/91, DateValue también reconoce 30 de diciembre de 1991 y 30 de dic., 1991.
Si se omite la parte de año de StringDate, DateValue utiliza el año actual de la fecha del sistema del equipo.
Si el argumento StringDate incluye información de hora, DateValue no la incluye en el valor devuelto. Sin embargo, si StringDate incluye información de hora no válida (como "89:98"), se producirá un error InvalidCastException.
Ejemplo
Este ejemplo utiliza la función DateValue para convertir una cadena en una fecha. También pueden utilizarse literales de fecha para asignar directamente una fecha a una variable Object o Date, por ejemplo oldDate = #2/12/69#.
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
Requisitos
Espacio de nombres:Microsoft.VisualBasic
**Módulo:**DateAndTime
**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)
Vea también
Referencia
DateSerial (Función, Visual Basic)
TimeSerial (Función, Visual Basic)
TimeValue (Función, Visual Basic)
Weekday (Función, Visual Basic)