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 Date valor 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 cadena que representa un valor de fecha y hora de 00:00:00 el 1 de enero del año 1 al 23:59:59 el 31 de diciembre de 9999.
Devoluciones
Valor 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 tiempo 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 del calendario actual de la CurrentCulture propiedad de la CultureInfo clase en el System.Globalization espacio de nombres . Los valores predeterminados CurrentCulture se determinan mediante la configuración del Panel de control . Puede invalidar el formato De fecha corta estableciendo la ShortDatePattern propiedad de la DateTimeFormatInfo clase en el System.Globalization espacio de nombres.
DateValue reconoce nombres de mes en formato largo, abreviado y numérico. Por ejemplo, además de reconocer 12/30/1991 y 12/30/91, 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 hora no válida, como "89:98", se produce un InvalidCastException error.