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.