Función DATETIMEVALUE ER
La función DATETIMEVALUE
devuelve un valor DateTime que se convierte de un determinado valor de texto en el formato especificado y en una cultura opcionalmente especificada a un valor de fecha/hora. Para obtener información acerca de los formatos admitidos, vea estándar y personalizado.
Sintaxis 1
DATETIMEVALUE (text, format)
Sintaxis 2
DATETIMEVALUE (text, format, culture)
Argumentos
text
: Cadena
Texto que representa el valor a formatear.
format
: Cadena
El formato del texto proporcionado. Para obtener información acerca de los formatos admitidos, vea estándar y personalizado.
culture
: Cadena
La cultura que se utiliza para formatear el texto dado. Para obtener información sobre las culturas admitidas, consulte cultura.
Valores de retorno
Fecha y hora
El valor de fecha/hora resultante.
Notas de uso
Cuando la cultura no se define como un argumento de la función llamada, el valor de culture
está definido por el contexto de llamada. Por ejemplo, si la función DATETIMEVALUE
se llama mediante el uso de la sintaxis 1 en un formato de informe electrónico (ER) para un elemento ARCHIVO configurado para usar la cultura alemana, la conversión se realizará utilizando la cultura alemana. El valor de culture
predeterminado es EN-US.
Ejemplo 1
DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss")
devuelve la 2:55:00 AM del 21 de diciembre de 2016 basada el formato especificado y la cultura predeterminada EN-US de la aplicación.
Ejemplo 2
DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "IT")
devuelve 2:55:00 a.m. del 21 de diciembre de 2016, según el formato y la cultura personalizados especificados.
Sin embargo, DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "EN-US")
lanza una excepción para informar al usuario de que la cadena especificada no se reconoce como valor fecha/hora válido para la cultura especificada.