DateAndTime.DateValue(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve un valor de Date que contiene la información de fecha representada por una cadena, con la información de hora establecida en medianoche (00:00:00).
public:
static DateTime DateValue(System::String ^ StringDate);
public static DateTime DateValue (string StringDate);
static member DateValue : string -> DateTime
Public Function DateValue (StringDate As String) As DateTime
Parámetros
- StringDate
- String
Obligatorio. Expresión de tipo String que representa un valor de fecha u hora desde las 00:00:00 horas del 1 de enero del año 1 hasta las 23:59:59 horas del 31 de diciembre de 9999.
Devoluciones
Valor de tipo Date que contiene la información de fecha representada por una cadena, con la información de hora establecida en medianoche (00:00:00).
Excepciones
StringDate incluye información de hora no válida.
Ejemplos
En este ejemplo se usa la DateValue función para convertir una cadena en una fecha. También puede usar literales de fecha para asignar directamente una fecha a una Object variable o Date , por ejemplo, oldDate = #2/12/69#.
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
Comentarios
Si StringDate solo incluye números de 1 a 12 separados por separadores de fecha válidos, DateValue reconoce el orden del mes, el día y el año según el formato de fecha corta especificado para el sistema.
DateValue usa la configuración de calendario actual de la CurrentCulture propiedad de la CultureInfo clase en el System.Globalization espacio de nombres . Los valores predeterminados CurrentCulture se determinan mediante Panel de control configuración. Puede invalidar el formato Fecha corta estableciendo la ShortDatePattern propiedad de la DateTimeFormatInfo clase en el System.Globalization espacio de nombres .
DateValue reconoce nombres de mes en forma larga, abreviada y numérica. Por ejemplo, además de reconocer el 30/12/1991 y el 30/12/91 de diciembre de 1991, DateValue también reconoce el 30 de diciembre de 1991 y el 30 de diciembre de 1991.
Si se omite la parte del año de StringDate , DateValue usa el año actual de la fecha del sistema del equipo.
Si el StringDate argumento incluye información de tiempo, DateValue no lo incluye en el valor devuelto. Sin embargo, si StringDate incluye información de tiempo no válida, como "89:98", se produce un InvalidCastException error.