Funzioni di data e ora (SPSS Modeler) | IBM Cloud Pak for Data as a Service

Torna alla versione inglese della documentazione

Funzioni di data e ora

Ultimo aggiornamento: 07 ott 2024

Funzioni di data e ora (SPSS Modeler)

CLEM include una famiglia di funzioni per la gestione dei campi con archiviazione data / ora delle variabili stringa che rappresentano date e ore.

I formati di data e ora utilizzati sono specifici per ciascun flusso e sono specificati nelle proprietà del flusso. Le funzioni di data e ora analizzano le stringhe di data e ora in base al formato correntemente selezionato.

Quando si specifica un anno in una data che utilizza solo due cifre (ossia, il secolo non è specificato), SPSS Modeler utilizza il secolo predefinito specificato nelle proprietà di flusso.

Tabella 1. Funzioni di data e ora CLEM
Funzione	Risultato:	Descrizione
`@TODAY`	Stringa	Se si seleziona Rollover giorni/min nelle proprietà del flusso, questa funzione restituisce la data corrente come una stringa nel formato della data corrente. Se si utilizza un formato data a due cifre e non si seleziona Rollover giorni/min, questa funzione restituisce $null$ sul server corrente.
`to_time(ITEM)`	Ora	Converte il tipo di archiviazione del campo specificato in un'ora.
`to_date(ITEM)`	Data	Converte il tipo di archiviazione del campo specificato in una data.
`to_timestamp(ITEM)`	Data/ora	Converte il tipo di archiviazione del campo specificato in un timestamp.
`to_datetime(ITEM)`	Data e ora	Converte il tipo di archiviazione del campo specificato in un valore di data, ora o timestamp.
`datetime_date(ITEM)`	Data	Restituisce il valore di data per un numero, una stringa o un timestamp. Si noti che questa è la sola funzione che consente di convertire un numero (in secondi) nuovamente in una data. Se `ITEM` è una stringa, crea una data analizzando una stringa nel formato di data corrente. Il formato data specificato nelle proprietà del flusso deve essere corretto perché questa funzione abbia esito positivo. Se `ITEM` è un numero, viene interpretato come un numero di secondi dalla data di base (o epoch). Le frazioni di giorno vengono troncate. Se `ITEM` è un timestamp, viene restituita la parte relativa alla data del timestamp. Se `ITEM` è una data, viene restituito invariato.
`date_before(DATE1, DATE2)`	Booleano	Restituisce un valore vero se DATE1 rappresenta una data o un timestamp precedente a quella rappresentata da DATE2. In caso contrario, questa funzione restituirà un valore 0.
`date_days_difference(DATE1, DATE2)`	Intero	Restituisce il tempo in giorni dalla data o dal timestamp rappresentato da DATE1 a quello rappresentato da DATE2, sotto forma di numero intero. Se DATE2 è antecedente a DATE1, questa funzione restituisce un numero negativo.
`date_in_days(DATE)`	Intero	Restituisce il tempo in giorni trascorso dalla data di riferimento alla data o al timestamp rappresentato da DATE, sotto forma di numero intero. Se il valore di DATE è precedente alla data di riferimento, questa funzione restituisce un numero negativo. Per ottenere un calcolo corretto è necessario includere una data valida. Per esempio, 29 febbraio 2001 non è una data valida. Poiché il 2001 non è un anno bisestile, questa data non esiste.
`date_in_months(DATE)`	Reale	Restituisce il tempo in mesi trascorso dalla data di riferimento alla data o al timestamp rappresentato da DATE, sotto forma di numero reale. Tale numero corrisponde a una cifra approssimativa basata su un mese formato da 30.4375 giorni. Se il valore di DATE è precedente alla data di riferimento, questa funzione restituisce un numero negativo. Per ottenere un calcolo corretto è necessario includere una data valida. Per esempio, 29 febbraio 2001 non è una data valida. Poiché il 2001 non è un anno bisestile, questa data non esiste.
`date_in_weeks(DATE)`	Reale	Restituisce il tempo in settimane trascorso dalla data di riferimento alla data o al timestamp rappresentato da DATE, sotto forma di numero reale. Tale numero è basato su una settimana formata da sette giorni. Se il valore di DATE è precedente alla data di riferimento, questa funzione restituisce un numero negativo. Per ottenere un calcolo corretto è necessario includere una data valida. Per esempio, 29 febbraio 2001 non è una data valida. Poiché il 2001 non è un anno bisestile, questa data non esiste.
`date_in_years(DATE)`	Reale	Restituisce il tempo in anni trascorso dalla data di riferimento alla data o al timestamp rappresentato da DATE, sotto forma di numero reale. Tale numero corrisponde a una cifra approssimativa basata su un anno formato da 365.25 giorni. Se il valore di DATE è precedente alla data di riferimento, questa funzione restituisce un numero negativo. Per ottenere un calcolo corretto è necessario includere una data valida. Per esempio, 29 febbraio 2001 non è una data valida. Poiché il 2001 non è un anno bisestile, questa data non esiste.
`date_months_difference (DATE1, DATE2)`	Reale	Restituisce il tempo in mesi dalla data o dal timestamp rappresentato da DATE1 a quello rappresentato da DATE2, sotto forma di numero reale. Tale numero corrisponde a una cifra approssimativa basata su un mese formato da 30.4375 giorni. Se DATE2 è antecedente a DATE1, questa funzione restituisce un numero negativo.
`datetime_date(YEAR, MONTH, DAY)`	Data	Crea il valore di data per gli argomenti YEAR, MONTH e DAY specificati. Gli argomenti devono essere numeri interi.
`datetime_day(DATE)`	Intero	Restituisce il giorno del mese di una DATE o un timestamp. Il risultato è un numero intero nell'intervallo da 1 a 31.
`datetime_day_name(DAY)`	Stringa	Restituisce il nome completo dell'argomento DAY specificato. L'argomento deve essere un numero intero nell'intervallo compreso tra 1 (domenica) e 7 (sabato).
`datetime_hour(TIME)`	Intero	Restituisce l'ora dal valore TIME o da un timestamp. Il risultato è un numero intero nell'intervallo da 0 a 23.
`datetime_in_seconds(TIME)`	Reale	Restituisce la parte in secondi memorizzata in TIME.
`datetime_in_seconds(DATE)`, `datetime_in_seconds(DATETIME)`	Reale	Restituisce il numero accumulato, convertito in secondi, dalla differenza tra il valore DATE o DATETIME corrente e la data di riferimento (1900-01-01).
`datetime_minute(TIME)`	Intero	Restituisce i minuti dal valore TIME o da un timestamp. Il risultato è un numero intero compreso tra 0 e 59.
`datetime_month(DATE)`	Intero	Restituisce il mese da una DATE o da un timestamp. Il risultato è un numero intero compreso tra 1 e 12.
`datetime_month_name (MONTH)`	Stringa	Restituisce il nome completo dell'argomento MONTH specificato. L'argomento deve essere un numero intero nell'intervallo da 1 a 12.
`datetime_now`	Data/ora	Restituisce l'ora corrente come timestamp.
`datetime_second(TIME)`	Intero	Restituisce i secondi dal valore TIME o da un timestamp. Il risultato è un numero intero compreso tra 0 e 59.
`datetime_day_short_name` `(DAY)`	Stringa	Restituisce il nome abbreviato dell'argomento DAY specificato. L'argomento deve essere un numero intero nell'intervallo compreso tra 1 (domenica) e 7 (sabato).
`datetime_month_short_name` `(MONTH)`	Stringa	Restituisce il nome abbreviato dell'argomento MONTH specificato. L'argomento deve essere un numero intero nell'intervallo da 1 a 12.
`datetime_time(HOUR, MINUTE, SECOND)`	Ora	Restituisce il valore di ora per gli argomenti TIME, MINUTE, e SECOND specificati. Gli argomenti devono essere numeri interi.
`datetime_time(ITEM)`	Ora	Restituisce il valore di ora dell'ITEM specificato.
`datetime_timestamp(YEAR, MONTH, DAY, HOUR, MINUTE, SECOND)`	Data/ora	Restituisce il valore di timestamp per l'YEAR, il MONTH, il DAY, l'HOUR, i MINUTE e i SECONDI specificati.
`datetime_timestamp(DATE, TIME)`	Data/ora	Restituisce il valore di timestamp per la DATE e l'TIME specificate.
`datetime_timestamp` `(NUMBER)`	Data/ora	Restituisce il valore di timestamp del numero di secondi specificato.
`datetime_weekday(DATE)`	Intero	Restituisce il giorno della settimana dalla DATE o dal timestamp specificato.
`datetime_year(DATE)`	Intero	Restituisce l'anno da una DATE o da un timestamp. Il risultato è un numero intero come 2021.
`date_weeks_difference` `(DATE1, DATE2)`	Reale	Restituisce il tempo in settimane dalla data o dal timestamp rappresentato da DATE1 a quello rappresentato da DATE2, sotto forma di numero reale. Tale numero è basato su una settimana formata da sette giorni. Se DATE2 è antecedente a DATE1, questa funzione restituisce un numero negativo.
`date_years_difference (DATE1, DATE2)`	Reale	Restituisce il tempo in anni dalla data o dal timestamp rappresentato da DATE1 a quello rappresentato da DATE2, sotto forma di numero reale. Tale numero corrisponde a una cifra approssimativa basata su un anno formato da 365.25 giorni. Se DATE2 è antecedente a DATE1, questa funzione restituisce un numero negativo.
`date_from_ywd(YEAR, WEEK, DAY)`	Intero	Converte l'anno, la settimana dell'anno ed il giorno della settimana in una data con lo standard ISO 8601.
`date_iso_day(DATE)`	Intero	Restituisce il giorno della settimana dalla data utilizzando lo standard ISO 8601.
`date_iso_week(DATE)`	Intero	Restituisce la settimana dell'anno dalla data utilizzando lo standard ISO 8601.
`date_iso_year(DATE)`	Intero	Restituisce l'anno dalla data utilizzando lo standard ISO 8601.
`time_before(TIME1, TIME2)`	Booleano	Restituisce un valore vero se TIME1 rappresenta un'ora o un timestamp precedente a quello rappresentata da TIME2. In caso contrario, questa funzione restituirà un valore 0.
`time_hours_difference (TIME1, TIME2)`	Reale	Restituisce il tempo trascorso in ore tra le ore o timestamp rappresentati da TIME1 e TIME2, sotto forma di numero reale. Se si seleziona Rollover giorni/min nelle proprietà del flusso, viene utilizzato un valore superiore di TIME1 per fare riferimento al giorno precedente. Se non si seleziona l'opzione di rollover, un valore più alto di TIME1 fa sì che il valore restituito sia negativo.
`time_in_hours(TIME)`	Reale	Restituisce il tempo in ore rappresentato dall'ora TIME, sotto forma di numero reale. Con il formato di ora `HHMM`, per esempio, l'espressione `time_in_hours('0130')` restituisce 1.5. TIME può rappresentare un'ora o un timestamp.
`time_in_mins(TIME)`	Reale	Restituisce il tempo in minuti rappresentato da TIME, sotto forma di numero reale. TIME può rappresentare un'ora o un timestamp.
`time_in_secs(TIME)`	Intero	Restituisce il tempo in secondi rappresentato da TIME, sotto forma di numero intero. TIME può rappresentare un'ora o un timestamp.
`time_mins_difference(TIME1, TIME2)`	Reale	Restituisce il tempo trascorso in minuti tra le ore o timestamp rappresentati da TIME1 e TIME2, sotto forma di numero reale. Se si seleziona Rollover giorni/min nelle proprietà del flusso, un valore maggiore di TIME1 viene utilizzato per fare riferimento al giorno precedente (o all'ora precedente, se vengono specificati solo minuti e secondi nel formato corrente). Se non si seleziona l'opzione di rollover, un valore più elevato di TIME1 causerà la restituzione di un valore negativo.
`time_secs_difference(TIME1, TIME2)`	Intero	Restituisce la differenza in secondi tra le ore o timestamp rappresentati da TIME1 e TIME2, sotto forma di numero intero. Se si seleziona Rollover giorni/min nelle proprietà del flusso, un valore maggiore di TIME1 viene utilizzato per fare riferimento al giorno precedente (o all'ora precedente, se vengono specificati solo minuti e secondi nel formato corrente). Se non si seleziona l'opzione di rollover, un valore più alto di TIME1 fa sì che il valore restituito sia negativo.