Función DATETIMEFORMAT ER

La función DATETIMEFORMAT devuelve un valor Cadena que presenta un valor determinado de fecha/hora como texto en el formato especificado y en una cultura opcional especificada. Para obtener información acerca de los formatos admitidos, vea estándar y personalizado.

Sintaxis 1

DATETIMEFORMAT (datetime, format)

Sintaxis 2

DATETIMEFORMAT (datetime, format, culture)

Argumentos

datetime: Fecha y hora

Un valor de fecha / hora que representa la fecha y la hora a formatear.

format: Cadena

El formato de la cadena de salida. Para obtener información acerca de los formatos admitidos, vea estándar y personalizado.

Nota

La cadena de formato distingue mayúsculas de minúsculas cuando utiliza un formato estándar o un formato personalizado. Por ejemplo, el especificador de formato "d" estándar devuelve la fecha utilizando el patrón de fecha corta, mientras que el especificador de formato estándar "D" devuelve la fecha utilizando el patrón de fecha larga. Además, el especificador de formato "M" personalizado devuelve los meses del 1 al 12, mientras que el especificador de formato personalizado "m" devuelve los minutos del 0 al 59.

culture: Cadena

La cultura a utilizar para formatear. Para obtener información sobre las culturas admitidas, consulte cultura.

Valores de retorno

Cadena

El valor de cadena resultante.

Notas de uso

Si 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 DATETIMEFORMAT 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.

Cuando la función DATETIMEFORMAT convierte un valor de fecha / hora dado, considera la configuración de zona horaria del usuario de la aplicación que ejecuta el formato ER al que se llama la función en el contexto.

Ejemplo 1

DATETIMEFORMAT (NOW(), "dd-MM-yyyy") devuelve la fecha/hora del servidor actual, 24 de diciembre de 2015, como “24-12-2015”, basado en el formato personalizado especificado.

Ejemplo 2

DATETIMEFORMAT (SESSIONNOW(), "d", "DE") devuelve la fecha/hora de sesión de la aplicación actual, 24 de diciembre de 2015, como la cadena "24.12.2015", basado en la cultura alemana seleccionada y el formato especificado.

Ejemplo 3

DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") devuelve el valor de la cadena 2019-11-12T08:00:00.0000000-08:00 cuando se llama a la función durante un proceso iniciado por un usuario de la aplicación que tiene el valor de zona horaria (GMT-08: 00) Hora del Pacífico (EE. UU. y Canadá) en la sección Preferencias de idioma y país / región.

Recursos adicionales

Funciones de fecha y de tiempo