Compartir a través de


DateAndTime.DateValue(String) Método

Definición

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.

Se aplica a

Consulte también