Función DATE_FORMAT: especifica el formato de visualización de la fecha y la hora
Al utilizar la función DATE_FORMAT en una fórmula, puede convertir valores de fecha, hora o fecha y hora en valores de cadena que utilizan un formato de fecha y hora especificado.
La función DATE_FORMAT también se utiliza al concatenar fechas y horas con otras cadenas de caracteres.
Sintaxis de la función DATE_FORMAT
FORMATO_FECHA(fecha_y_hora, "formato_fecha_y_hora","zona_horaria")
Hay tres argumentos que debe especificar para la función DATE_FORMAT: "date_and_time", "date_and_time_format" y "time_zone", en ese orden.
El primer argumento: "fecha_y_hora"
Para el primer argumento, especifique la fecha, la hora o la fecha y hora para las que desea especificar un formato de visualización.
Puede especificar el primer argumento utilizando un código de campo, hora Unix o fórmula.
Especificar el primer argumento utilizando un código de campo
Si desea especificar un código de campo, puede utilizar el código de campo de uno de los siguientes campos.
- Fecha y hora
- Fecha
- Hora
- Fecha y hora de creación
- Fecha y hora actualizadas
- Número
- Calculado
Si especifica el código de campo de un campo numérico o Calculado, el valor del campo se tratará como hora Unix.
Especificación del primer argumento utilizando una hora Unix
Los tiempos Unix se pueden especificar directamente.
Puede especificar un tiempo Unix desde -30610224000 hasta 253402300799.
Especificar el primer argumento mediante una fórmula
Para el primer argumento, también puede especificar una fórmula que genere un valor de fecha, hora o fecha y hora. Por ejemplo, puede especificar una fórmula que genere un resultado de cálculo tras sumar o restar la hora a un valor de fecha y hora.
Los siguientes operadores y funciones se pueden utilizar al especificar fórmulas.
- +
- -
- *
- /
- ^
- Función SUMA
Al ingresar un tiempo en una fórmula, especifique el tiempo en segundos.
Por ejemplo, especifique "3600" o "60*60*1" para representar una hora.
El siguiente ejemplo muestra una fórmula que muestra la fecha del día siguiente.
FORMATO_FECHA(fecha+24*60*60*1, "AAAA/MM/dd", "Etc/GMT")
El segundo argumento: "date_and_time_format"
Para el segundo argumento, especifique un formato de fecha y hora.
El formato de fecha y hora se puede especificar de una de las siguientes maneras.
- Especifique un formato de fecha y hora directamente
- Especifique un código de campo
Para obtener información sobre cómo especificar un formato de fecha y hora, consulte la siguiente sección.
Códigos de formato de fecha y hora
Si desea especificar un código de campo, puede utilizar el código de campo de uno de los siguientes campos.
- Texto
- Área de texto
Si desea agregar cadenas de caracteres a un formato de fecha y hora
Encierre cada una de las cadenas de caracteres que desee agregar entre comillas simples (es decir, '[cadena de caracteres]').
Por ejemplo, si desea mostrar un resultado de cálculo en el formato "Fecha: ***", especifique lo siguiente.
FORMATO_FECHA(código_campo, "'FECHA:' d", "Asia/Tokio")
Si desea agregar una comilla simple (') como carácter en un formato de fecha y hora, especifique dos comillas simples consecutivamente (es decir, '') en el formato de fecha y hora.
Por ejemplo, si desea mostrar un resultado de cálculo en el formato " 'Fecha: ***' ", especifique lo siguiente.
FORMATO_FECHA(código_campo, "'''FECHA:' d''", "Asia/Tokio")
El tercer argumento: "time_zone"
Para el tercer argumento, especifique una zona horaria.
Si especificó un campo de fecha u Hora para el primer argumento, especifique la zona horaria como "Etc/GMT" (el ID de zona horaria para Hora Universal Coordinado). Si especifica una zona horaria distinta a "Etc/GMT", podría haber desviaciones en la fecha o la hora.
FORMATO_FECHA(hora, "hh:mm", "Etc/GMT")
Si ha especificado otro tipo de campo o hora Unix para el primer argumento, especifique la zona horaria de su elección.
DATE_FORMAT(fecha_y_hora, "Md-AAAA", "Asia/Tokio")
Si especifica "sistema", se aplicará la zona horaria seleccionada en Administración Kintone.
Tratamiento del horario de verano
Si especifica una zona horaria que tiene horario de verano, se aplicará dicho horario al resultado del cálculo.
El siguiente ejemplo muestra una fórmula que especifica una zona horaria que tiene horario de verano.
FORMATO_FECHA(fecha_y_hora, "MM/dd/AAAA HH:mm ZZ", "América/Los_Ángeles")
Esta fórmula muestra los siguientes resultados de cálculo.
- "2019-01-01 00:00" UTC se convierte a "12/31/2018 16:00 -08:00".
- "2018-08-01 00:00" UTC se convierte a "07/31/2018 17:00 -07:00".
Códigos de formato de fecha y hora
Los siguientes códigos de formato se pueden utilizar en el formato de fecha y hora especificado como segundo argumento de una función DATE_FORMAT.
Código de formato para mostrar años
| Código | Ejemplo de conversión | Descripción |
|---|---|---|
| YYYY | 2020 | Convierte al año calendario occidental. También se puede usar "aaaa" en minúscula. |
Códigos de formato para mostrar los meses
| Código | Ejemplo de conversión | Descripción |
|---|---|---|
| MMMM | April 4月 | Convierte a un mes en el idioma de visualización del usuario que edita el registro. |
| MMM | Apr 4月 | Convierte a un mes en el idioma de visualización del usuario que edita el registro. Los meses en inglés se abrevian. |
| MM | 04 | Se convierte en un mes con relleno de ceros. |
| M | 4 | Convierte a un mes sin relleno de ceros. |
Códigos de formato para mostrar los días
| Código | Ejemplo de conversión | Descripción |
|---|---|---|
| dd | 01 | Se convierte en un día con relleno de ceros. |
| d | 1 | Convierte a un día sin relleno de ceros. |
Códigos de formato para mostrar horas
| Código | Ejemplo de conversión | Descripción |
|---|---|---|
| a | PM 午後 下午 | Convierte al marcador "AM" o "PM" en el idioma de visualización del usuario que edita el registro. |
| KK | 00 | Convierte al formato de 12 horas, donde de 0 a 11 se considera anterior al mediodía. Se aplica relleno de ceros. Cuando se especifica mediodía para el primer argumento ("date_and_time"), la hora se convierte a "00". |
| K | 0 | Convierte al formato de 12 horas, donde de 0 a 11 se considera anterior al mediodía. No se aplica relleno de ceros. Cuando se especifica mediodía para el primer argumento ("date_and_time"), la hora se convierte a "0". |
| hh | 12 | Se convierte al formato de 12 horas, donde entre la 1 y las 12 se considera anterior al mediodía. Se aplica relleno de ceros. Cuando se especifica mediodía para el primer argumento ("date_and_time"), la hora se convierte a "12". |
| h | 12 | Se convierte al formato de 12 horas, donde entre la 1 y las 12 se considera anterior al mediodía. No se aplica relleno de ceros. Cuando se especifica mediodía para el primer argumento ("date_and_time"), la hora se convierte a "12". |
| HH | 00 | Convierte al formato de 24 horas, donde el día va de las 0 a las 23. Se aplica relleno de ceros. Cuando se especifica medianoche para el primer argumento ("date_and_time"), la hora se convierte a "00". |
| H | 0 | Convierte al formato de 24 horas, donde el día va de las 0 a las 23. No se aplica relleno de ceros. Cuando se especifica medianoche para el primer argumento ("date_and_time"), la hora se convierte a "0". |
| kk | 24 | Convierte al formato de 24 horas, donde el día va de la 1 a las 24. Se aplica relleno de ceros. Cuando se especifica medianoche para el primer argumento ("date_and_time"), la hora se convierte a "24". |
| k | 24 | Convierte al formato de 24 horas, donde el día va de la 1 a las 24. No se aplica relleno de ceros. Cuando se especifica medianoche para el primer argumento ("date_and_time"), la hora se convierte a "24". |
Códigos de formato para mostrar minutos
| Código | Ejemplo de conversión | Descripción |
|---|---|---|
| mm | 05 | Convierte a minutos con relleno de ceros. |
| m | 5 | Convierte a minutos sin relleno de ceros. |
Códigos de formato para mostrar segundos
Los segundos no se guardan en los campos Kintone que manejan fechas y horas.
Si se especifica un código de campo como primer argumento de una función DATE_FORMAT, la cantidad de segundos se trata como 0.
| Código | Ejemplo de conversión | Descripción |
|---|---|---|
| ss | 01 | Convierte a segundos con relleno de ceros. Si especifica la hora Unix "1695179101" (20 de septiembre de 2023, 12:05:01 p. m.) con "ss" como formato, se convertirá a "01". |
| s | 1 | Convierte a segundos sin relleno de ceros. Si especifica la hora Unix "1695179101" (20 de septiembre de 2023 p.m. 12:05:01) con "s" como formato, se convertirá a "1". |
Códigos de formato para mostrar zonas horarias
| Código | Ejemplo de conversión | Descripción |
|---|---|---|
| Z | +0900 | Convierte a la diferencia horaria con respecto al UTC (Tiempo Universal Coordinado) según la zona horaria especificada como tercer argumento. La diferencia horaria se muestra en formato "hhmm". |
| ZZ | +09:00 | Convierte a la diferencia horaria con respecto al UTC (Tiempo Universal Coordinado) según la zona horaria especificada como tercer argumento. La diferencia horaria se muestra en formato "hh:mm". |
| ZZZ | Asia/Tokyo | Convierte al ID de zona horaria de la zona horaria especificada como tercer argumento. |
Ejemplos de fórmulas
Al especificar un campo en una fórmula, asegúrese de especificar el código de campo como argumento (y no el nombre del campo).
En los ejemplos siguientes, el código de campo se establece para cada campo como el nombre del campo con guiones bajos en lugar de espacios (por ejemplo, el código de campo para el campo "Fecha de solicitud" es "Fecha_de_solicitud").
Fórmula para cambiar el formato de un campo "Fecha" a "Md-AAAA"
La siguiente fórmula cambia el formato de un campo de fecha a "Md-AAAA".
FORMATO_FECHA(fecha_y_hora, "Md-AAAA", "Etc/GMT")
Si se ingresa "2020-04-01" en el campo Fecha, se convertirá a "4-1-2020".
Fórmula para cambiar el formato y la zona horaria de un campo "Fecha y hora"
La siguiente fórmula cambia el formato de un campo de fecha y hora a "MM-dd-AAAA HH:mm" y su zona horaria a hora estándar del Pacífico.
FORMATO_FECHA(fecha_y_hora, "MM-dd-AAAA HH:mm", "América/Los_Ángeles")
Si se ingresa "2020-04-01 13:00" (JST) en el campo "Fecha y hora", se convertirá a "03-31-2020 21:00".
Fórmula para mostrar un nombre combinado con la fecha y hora de creación de un registro
La siguiente fórmula muestra el valor ingresado en el campo "Nombre completo" junto con la fecha y hora de creación del registro. El formato de visualización es "[nombre completo] - [fecha y hora de creación]".
El nombre, el guion y la fecha y hora de creación se combinan utilizando el símbolo "&".
Nombre completo y "-" y FORMATO DE FECHA (Fecha y hora de creación, "MMddAAAA", "sistema")
Si se ingresa "Maria Jackson" en el campo "Nombre completo" y la fecha y hora de creación del registro es "31 de octubre de 2022, 16:42", el resultado del cálculo será "Maria Jackson-10312022".
Fórmula para mostrar el mes a partir de una fecha de nacimiento
La siguiente fórmula muestra el mes a partir de una fecha de nacimiento.
FORMATO_FECHA(Fecha_de_nacimiento, "MM", "Etc/GMT")
Si se ingresa "31 de diciembre de 1969" en el campo "Fecha de nacimiento", se mostrará "12".
Fórmula para calcular la fecha de finalización del período de prueba que es 30 días después de la fecha de solicitud
La siguiente fórmula muestra una fecha de finalización del período de prueba que es 30 días después de la fecha de solicitud.
FORMATO_FECHA(Fecha_de_aplicación + (60*60*24*30), "MM-dd-AAAA", "Etc/GMT")
Si se ingresa "01/07/2021" en el campo "Fecha de solicitud", el resultado del cálculo será "31/07/2021" (la fecha 30 días después de la fecha de solicitud).