Funciones de fecha y hora (SPSS Modeler) | IBM Cloud Pak for Data as a Service

Volver a la versión inglesa de la documentación

Funciones de fecha y hora

Última actualización: 07 oct 2024

Funciones de fecha y hora (SPSS Modeler)

CLEM incluye un grupo de funciones para la gestión de campos con almacenamiento de fecha y hora de variables de serie que representan fechas y horas.

Los formatos de fecha y hora utilizados son específicos de cada flujo y se especifican en las propiedades del flujo. Las funciones de fecha y hora analizan las cadenas de fecha y hora en función del formato seleccionado actualmente.

Cuando especifique un año en una fecha que solo utilice dos dígitos (es decir, no se especifica el siglo), SPSS Modeler utiliza el siglo predeterminado que se ha especificado en las propiedades del flujo.

Tabla 1. Funciones de fecha y hora de CLEM
Función	Resultado	Descripción
`@TODAY`	Serie	Si selecciona Admitir fecha/min. negativos en las propiedades del flujo, esta función devuelve la fecha actual como una serie en el formato de fecha actual. Si utiliza un formato de fecha de dos dígitos y no selecciona Admitir fecha/min. negativos, esta función devuelve $null$ en el servidor actual.
`to_time(ITEM)`	Hora	Convierte el almacenamiento del campo especificado en una hora.
`to_date(ITEM)`	Fecha	Convierte el almacenamiento del campo especificado en una fecha.
`to_timestamp(ITEM)`	Indicación de fecha y hora	Convierte el almacenamiento del campo especificado en una marca de tiempo.
`to_datetime(ITEM)`	Fecha y hora	Convierte el almacenamiento del campo especificado en una fecha, hora o marca de tiempo.
`datetime_date(ITEM)`	Fecha	Devuelve el valor de fecha de un número, cadena o marca de tiempo. Tenga en cuanta que es la única función que le permite volver a convertir un número (en segundos) en una fecha. Si `ITEM` es una serie, crea una fecha analizando una serie en el formato de fecha actual. El formato de fecha especificado en las propiedades del flujo debe ser el adecuado para que esta función se ejecute correctamente. Si `ITEM` es un número, se interpreta como un número de segundos desde la fecha base (o época). Las fracciones de un día se truncan. Si `ITEM` es una indicación de fecha y hora, se devuelve la parte de fecha de la indicación de fecha y hora. Si `ITEM` es una fecha, se devuelve sin cambios.
`date_before(DATE1, DATE2)`	Boolean	Devuelve un valor de verdadero si FECHA1 representa una fecha o marca de tiempo anterior a la representada por FECHA2. En el resto de los casos, esta función devuelve 0.
`date_days_difference(DATE1, DATE2)`	Entero	Devuelve el tiempo en días desde la fecha o marca de tiempo representada por FECHA1 hasta la fecha representada por FECHA2, como un entero. Si FECHA2 es anterior a FECHA1, esta función devuelve un número negativo.
`date_in_days(DATE)`	Entero	Devuelve el tiempo en días desde la fecha de línea base hasta la fecha o marca de tiempo representada por FECHA, como un entero. Si FECHA es anterior a la fecha de línea base, esta función devuelve un número negativo. Debe incluir una fecha válida para que el cálculo se realice correctamente. Por ejemplo, no debe especificar 29 de febrero de 2001 como fecha. Puesto que 2001 no es un año bisiesto, esta fecha no existe.
`date_in_months(DATE)`	Real	Devuelve el tiempo en meses desde la fecha de línea base hasta la fecha o marca de tiempo representada por FECHA, como un número real. Esta cifra es aproximada; se basa en un mes de 30.4375 días. Si FECHA es anterior a la fecha de línea base, esta función devuelve un número negativo. Debe incluir una fecha válida para que el cálculo se realice correctamente. Por ejemplo, no debe especificar 29 de febrero de 2001 como fecha. Puesto que 2001 no es un año bisiesto, esta fecha no existe.
`date_in_weeks(DATE)`	Real	Devuelve el tiempo en semanas desde la fecha de línea base hasta la fecha o marca de tiempo representada por FECHA, como un número real. Éste se basa en una semana de 7,0 días. Si FECHA es anterior a la fecha de línea base, esta función devuelve un número negativo. Debe incluir una fecha válida para que el cálculo se realice correctamente. Por ejemplo, no debe especificar 29 de febrero de 2001 como fecha. Puesto que 2001 no es un año bisiesto, esta fecha no existe.
`date_in_years(DATE)`	Real	Devuelve el tiempo en años desde la fecha de línea base hasta la fecha o marca de tiempo representada por FECHA, como un número real. Esta cifra es aproximada; se basa en un año de 365.25 días. Si FECHA es anterior a la fecha de línea base, esta función devuelve un número negativo. Debe incluir una fecha válida para que el cálculo se realice correctamente. Por ejemplo, no debe especificar 29 de febrero de 2001 como fecha. Puesto que 2001 no es un año bisiesto, esta fecha no existe.
`date_months_difference (DATE1, DATE2)`	Real	Devuelve el tiempo en meses desde la fecha o marca de tiempo representada por FECHA1 hasta la fecha representada por FECHA2, como un número real. Esta cifra es aproximada; se basa en un mes de 30.4375 días. Si FECHA2 es anterior a FECHA1, esta función devuelve un número negativo.
`datetime_date(YEAR, MONTH, DAY)`	Fecha	Crea un valor de fecha para los valores AÑO, MES y DÍA especificados. Los argumentos deben ser enteros.
`datetime_day(DATE)`	Entero	Devuelve el día del mes de una FECHA o marca de tiempo especificada. El resultado es un entero comprendido entre 1 y 31.
`datetime_day_name(DAY)`	Serie	Devuelve el nombre completo del DÍA especificado. El argumento debe ser un entero comprendido entre 1 (domingo) y 7 (sábado).
`datetime_hour(TIME)`	Entero	Devuelve la hora de una HORA o marca de tiempo. El resultado es un entero comprendido entre 0 y 23.
`datetime_in_seconds(TIME)`	Real	Devuelve la segunda parte almacenada en TIEMPO.
`datetime_in_seconds(DATE)`, `datetime_in_seconds(DATETIME)`	Real	Devuelve el número acumulado, convertido en segundos, desde la diferencia entre la FECHA o MOMENTO DE FECHA actual y la fecha de línea base (01-01-1900).
`datetime_minute(TIME)`	Entero	Devuelve el minuto de una HORA o marca de tiempo. El resultado es un entero comprendido entre 0 y 59.
`datetime_month(DATE)`	Entero	Devuelve el mes de una FECHA o marca de tiempo. El resultado es un entero comprendido entre 1 y 12.
`datetime_month_name (MONTH)`	Serie	Devuelve el nombre completo del MES especificado. El argumento debe ser un entero comprendido entre 1 y 12.
`datetime_now`	Indicación de fecha y hora	Devuelve la hora actual como una marca de tiempo.
`datetime_second(TIME)`	Entero	Devuelve el segundo de una HORA o marca de tiempo. El resultado es un entero comprendido entre 0 y 59.
`datetime_day_short_name` `(DAY)`	Serie	Devuelve el nombre abreviado del DÍA especificado. El argumento debe ser un entero comprendido entre 1 (domingo) y 7 (sábado).
`datetime_month_short_name` `(MONTH)`	Serie	Devuelve el nombre abreviado del MES especificado. El argumento debe ser un entero comprendido entre 1 y 12.
`datetime_time(HOUR, MINUTE, SECOND)`	Hora	Devuelve el valor de tiempo para los valores HORA, MINUTO y SEGUNDO especificados. Los argumentos deben ser enteros.
`datetime_time(ITEM)`	Hora	Devuelve el valor de tiempo del ELEMENTO especificado.
`datetime_timestamp(YEAR, MONTH, DAY, HOUR, MINUTE, SECOND)`	Indicación de fecha y hora	Devuelve el valor de marca de tiempo para los valores AÑO, MES, DÍA, HORA, MINUTO y SEGUNDO especificados.
`datetime_timestamp(DATE, TIME)`	Indicación de fecha y hora	Devuelve el valor de marca de tiempo para los valores FECHA y HORA especificados.
`datetime_timestamp` `(NUMBER)`	Indicación de fecha y hora	Devuelve el valor de marca de tiempo del número especificado de segundos.
`datetime_weekday(DATE)`	Entero	Devuelve el día de la semana a partir de la FECHA o marca de tiempo especificada.
`datetime_year(DATE)`	Entero	Devuelve el año a partir de una FECHA o marca de tiempo. Esto da lugar a un entero, como por ejemplo 2021.
`date_weeks_difference` `(DATE1, DATE2)`	Real	Devuelve el tiempo en semanas desde la fecha o marca de tiempo representada por FECHA1 hasta la fecha representada por FECHA2, como un número real. Éste se basa en una semana de 7,0 días. Si FECHA2 es anterior a FECHA1, esta función devuelve un número negativo.
`date_years_difference (DATE1, DATE2)`	Real	Devuelve el tiempo en años desde la fecha o marca de tiempo representada por FECHA1 hasta la fecha representada por FECHA2, como un número real. Esta cifra es aproximada; se basa en un año de 365.25 días. Si FECHA2 es anterior a FECHA1, esta función devuelve un número negativo.
`date_from_ywd(YEAR, WEEK, DAY)`	Entero	Convierte el año, semana del año y día de la semana a una fecha utilizando el estándar ISO 8601.
`date_iso_day(DATE)`	Entero	Devuelve el día de la semana a partir de la fecha utilizando el estándar ISO 8601.
`date_iso_week(DATE)`	Entero	Devuelve la semana del año a partir de la fecha utilizando el estándar ISO 8601.
`date_iso_year(DATE)`	Entero	Devuelve el año a partir de la fecha utilizando el estándar ISO 8601.
`time_before(TIME1, TIME2)`	Boolean	Devuelve un valor verdadero si HORA1 representa una hora o marca de tiempo anterior a la representada por HORA2. En el resto de los casos, esta función devuelve 0.
`time_hours_difference (TIME1, TIME2)`	Real	Devuelve el número de horas de diferencia que hay entre las horas o marcas de tiempo representadas por HORA1 y HORA2, como un número real. Si selecciona Admitir fecha/min. negativos en las propiedades del flujo, se toma un valor superior de TIME1 para hacer referencia al día anterior. Si no selecciona esta opción, un valor superior de TIME1 hace que el valor devuelto sea negativo.
`time_in_hours(TIME)`	Real	Devuelve el número de horas representado por HORA, como un número real. Por ejemplo, con el formato de hora `HHMM`, la expresión `time_in_hours('0130')` se evalúa como 1,5. HORA puede representar una hora o una marca de tiempo.
`time_in_mins(TIME)`	Real	Devuelve el número de minutos representado por HORA, como un número real. HORA puede representar una hora o una marca de tiempo.
`time_in_secs(TIME)`	Entero	Devuelve el número de segundos representado por HORA, como un entero. HORA puede representar una hora o una marca de tiempo.
`time_mins_difference(TIME1, TIME2)`	Real	Devuelve el número de minutos de diferencia que hay entre las horas o marcas de tiempo representadas por HORA1 y HORA2, como un número real. Si selecciona Admitir fecha/min. negativos en las propiedades del flujo, se toma un valor superior de TIME1 para hacer referencia al día anterior (o a la hora anterior si solo se especifican minutos y segundos en el formato actual). Si no selecciona esta opción, un valor superior de TIME1 hace que el valor devuelto sea negativo.
`time_secs_difference(TIME1, TIME2)`	Entero	Devuelve el número de segundos de diferencia que hay entre las horas o marcas de tiempo representadas por HORA1 y HORA2, como un entero. Si selecciona Admitir fecha/min. negativos en las propiedades del flujo, se toma un valor superior de TIME1 para hacer referencia al día anterior (o a la hora anterior si solo se especifican minutos y segundos en el formato actual). Si no selecciona esta opción, un valor superior de TIME1 hace que el valor devuelto sea negativo.