La herramienta Crear fecha hora crea un campo de fecha utilizando valores de campo existentes.
Ejemplos
La herramienta Crear fecha hora se puede utilizar en escenarios como los siguientes:
- Un dataset de seguimiento de huracanes contiene una representación en forma de cadena de la hora de observación. Utilice la herramienta Crear fecha hora para dar formato y salida al campo de cadena como campo de fecha.
- Un dataset almacena información temporal a través de los campos Hour, Minute, y Second. Utilice la herramienta Crear fecha y hora para especificar estos campos y los formatos de los valores de campo para crear un nuevo campo de fecha.
Parámetros
En la tabla siguiente se describen los parámetros utilizados en la herramienta Crear fecha hora.
| Parámetro | Descripción |
|---|---|
Dataset de entrada | El dataset que contiene los valores de campo que se utilizarán para crear el campo de fecha. |
Campos | Una lista de uno o más campos y el formato de los valores de fecha u hora contenidos en el campo especificado. |
Campo de tiempo | Campo que contiene valores de fecha u hora. |
Formato de hora | El formato de los valores del campo de hora. |
Conservar campos de origen | Especifica si los campos utilizados para crear una fecha se mantendrán en la salida. |
Zona horaria | La zona horaria de los valores de entrada. |
Nombre de campo de hora de salida | El nombre del campo de hora de salida. Es un parámetro opcional. El valor predeterminado es TIMESTAMP. |
Notas de uso
Utilice el parámetro Dataset de entrada para identificar el dataset que contiene los valores de campo que se utilizarán para crear el campo fecha. El dataset se devolverá en la salida con la nueva columna de fecha agregada.
Utilice el parámetro Campos para especificar uno o más campos para calcular los valores de fecha de salida. La salida es un único campo de fecha. A continuación se ofrecen ejemplos de campos de entrada y formatos:
- Usted tiene un campo de cadena llamado MY_DATE_TIME con n valor de 2022-12-30 17:30:00. Especifique MYDATETIME para el campo de hora y un valor de yyyy-MM-dd HH:mm:ss para el formato de hora.
- Tiene dos campos: MY_DATE con valor de 07/25/2000 y MY_TIME con un valor de 5:30:00 PM. Especifique dos pares de campo y formato. Especifique el primer campo de hora como MY_DATE con un valor de formato de MM/dd/yyyy y el segundo campo de hora como MY_TIME con un valor de formato de hh:mm:ss a.
De forma predeterminada, los campos utilizados para crear la fecha se eliminarán del dataset de salida. Para mantener los campos de entrada, habilite el parámetro Mantener campos de origen.
El parámetro Zona horaria indica la zona horaria en la que se almacenan los valores horarios de entrada. El valor predeterminado es el tiempo universal coordinado (UTC). Si especifica un valor distinto de UTC, los valores de entrada se calcularán utilizando el valor horario especificado, pero el campo horario de salida se convertirá a UTC.
Las zonas horarias se basan en Joda-Time. Para obtener más información sobre los formatos de Joda-Time, consulte Zonas horarias con disponibilidad para Joda-Time.
Formatos de hora en Data Pipelines
| Valor | Descripción | Ejemplo |
|---|---|---|
aa | El año, representado por dos dígitos. | 16 |
aaaa | El año, representado por cuatro dígitos. | 2016 |
MM | El mes, representado numéricamente. | 01 o 1 |
MMM | El mes, representado con tres letras. | Jan |
MMMM | El mes, representado con el nombre completo. | January |
dd | El día. | 02 o 2 |
HH | La hora usando un día de 24 horas; valores entre 0 y 23. | 21 |
hh | La hora usando un día de 12 horas; valores entre 1 y 12. | 9 |
mm | Los minutos; valores entre 0 y 59. | 45 |
ss | Los segundos; valores entre 0 y 59. | 02 |
SSS | Los milisegundos; valores entre 0 y 999. | 50 |
a | Marcador AM/PM. | PM |
epoch_millis | El tiempo en milésimas de segundo desde epoch. | 1509581781000 |
epoch_seconds | El tiempo en segundos desde epoch. | 1509747601 |
Z | El desplazamiento de zona horaria expresado en horas. | -0100 o -01:00 |
ZZZ | El desplazamiento de zona horaria expresado mediante Id. | America/Los_Angeles |
'' | Las comillas simples añaden texto que no representa un valor descrito en esta tabla. | 'T' |
Salidas
La herramienta crea un único campo de fecha. Todos los pares de campo de hora y formato que especifique se utilizarán para crear un único valor de fecha. Para crear varios campos de fecha, ejecute la herramienta varias veces.
La salida de la herramienta incluye un dataset con todos los campos del dataset de entrada, además de un campo de fecha nuevo. Si no ha especificado el nombre del campo de salida, el campo de hora se llamará TIMESTAMP de forma predeterminada. El tipo de campo de salida es date y contiene la información de fecha y hora de cada registro.
Al previsualizar los campos de fecha, los valores se mostrarán en zona de tiempo del navegador. Cuando los valores se escriban en una capa de entidades, se almacenarán en UTC.
Limitaciones
Las siguientes son las limitaciones conocidas de la herramienta Crear fecha hora:
- La herramienta devuelve un único campo de fecha. Para calcular varios campos de fecha, configure las herramientas adicionales Crear fecha hora.
- Los pares de campo y formato especificados deben calcular un valor de fecha completo, por ejemplo, 12/23/2022 12:30:00. Los valores de solo fecha como 12/23/2022 o de solo hora como 12:30:00 son incompatibles con los campos de tipo fecha.
- El formato debe coincidir exactamente con los valores del campo especificado. Por ejemplo, no puede utilizar un formato de MM/dd/yyyy si el campo contiene un subconjunto de esos valores como 12/30.
Requisitos de licencia
Se requieren las siguientes licencias y configuraciones:
- Tipo de usuario Creator o Professional
- Rol de publicador, moderador o administrador, o rol personalizado equivalente
Para obtener más información sobre los requisitos de Data Pipelines, consulte Requisitos.