Le funzioni data e ora di Qlik Sense consentono di trasformare e convertire i valori di data e ora. Tutte le funzioni possono essere utilizzate sia nello script di caricamento dei dati che nelle espressioni grafiche.
Le funzioni sono basate su un numero seriale di data e ora che equivale al numero di giorni trascorsi dal 30 dicembre 1899. Il valore di numero intero rappresenta il giorno e il valore frazionale rappresenta l'ora del giorno.
Qlik Sense utilizza il valore numerico del parametro, pertanto un numero è valido come parametro anche quando non è formattato come data oppure come ora. Se il parametro non corrisponde a un valore numerico, ad esempio una stringa, Qlik Sense tenta di interpretare la stringa in base alle variabili di ambiente della data e dell'ora.
Se il formato dell'ora utilizzato nel parametro non corrisponde a quello impostato nelle variabili di ambiente, Qlik Sense non sarà in grado di eseguire un'interpretazione corretta. Per risolvere questo problema, modificare le impostazioni o utilizzare una funzione di interpretazione.
Negli esempi per ciascuna funzione vengono utilizzati i formati predefiniti di ora e data hh:mm:ss e YYYY-MM-DD (ISO 8601).
Quando elabora un valore di data e ora con una funzione data o ora, Qlik Sense ignora eventuali parametri relativi all'ora legale, a meno che la funzione data o ora non comprenda una posizione geografica.
Ad esempio, la funzione ConvertToLocalTime( filetime('Time.qvd'), 'Paris') utilizzerà i parametri relativi all'ora legale, mentre la funzione ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00') non li utilizzerà.
Utilizzare l'elenco a discesa su ciascuna funzione per visualizzare una breve descrizione e la sintassi di ciascuna funzione. Per ulteriori informazioni, fare clic sul nome della funzione nella descrizione della sintassi.
Espressioni di numero intero dell'ora
Questa funzione restituisce un numero intero che rappresenta il secondo in cui la frazione di expression viene interpretata come ora in base all'interpretazione numerica standard.
second(expression)
Questa funzione restituisce un numero intero che rappresenta il minuto in cui la frazione di expression viene interpretata come ora in base all'interpretazione numerica standard.
minute(expression)
Questa funzione restituisce un numero intero che rappresenta l'ora in cui la frazione di expression viene interpretata come ora in base all'interpretazione numerica standard.
hour(expression)
Questa funzione restituisce un numero intero che rappresenta il giorno in cui la frazione di expression viene interpretata come data in base all'interpretazione numerica standard.
day(expression)
Questa funzione restituisce un numero intero che rappresenta il numero della settimana in base allo standard ISO 8601. Il numero della settimana viene calcolato a partire dall'interpretazione della data dell'espressione in base all'interpretazione numerica standard.
week(expression)
Questa funzione restituisce un valore duale: il nome del mese come definito nella variabile di ambiente MonthNames e un numero intero compreso tra 1 e 12. Il numero del mese viene calcolato a partire dall'interpretazione della data dell'espressione in base all'interpretazione numerica standard.
month(expression)
Questa funzione restituisce un numero intero che rappresenta l'anno in cui expression viene interpretato come data in base all'interpretazione numerica standard.
year(expression)
Questa funzione restituisce l'anno a cui appartiene il numero della settimana in base allo standard ISO 8601. I numeri della settimana rientrano in un intervallo approssimativo compreso tra 1 e 52.
weekyear(expression)
Questa funzione restituisce un valore duale con:
- Il nome di un giorno come definito nella variabile di ambiente DayNames.
- Un numero intero compreso tra 0 e 6 che corrisponde al giorno nominale della settimana (0-6).
weekday(date)
Funzioni timestamp
Questa funzione restituisce un indicatore temporale dell'ora attuale. La funzione restituisce i valori nel formato della variabile di sistema TimeStamp. Il valore predefinito timer_mode è 1.
now([ timer_mode])
Questa funzione restituisce la data attuale. La funzione restituisce i valori nel formato della variabile di sistema DateFormat.
today([timer_mode])
Questa funzione restituisce un indicatore temporale dell'ora attuale fornita per il fuso orario specificato.
localtime([timezone [, ignoreDST ]])
Funzioni make
Questa funzione restituisce una data calcolata dall'anno YYYY, dal mese MM e dal giorno DD.
makedate(YYYY [ , MM [ , DD ] ])
Questa funzione restituisce una data calcolata dall'anno YYYY, dalla settimana WW e dal giorno della settimana D.
makeweekdate(YYYY [ , WW [ , D ] ])
Questa funzione restituisce una data calcolata dall'ora hh, dal minuto mm e dal secondo ss.
maketime(hh [ , mm [ , ss [ .fff ] ] ])
Altre funzioni date
Questa funzione restituisce la data che ricorre n mesi dopo startdate oppure, se n è negativo, la data che ricorre n mesi prima di startdate.
addmonths(startdate, n , [ , mode])
Questa funzione restituisce la data che ricorre n anni dopo startdate oppure, se n è negativo, la data che ricorre n anni prima di startdate.
addyears(startdate, n)
Questa funzione stabilisce se l'indicatore temporale di input ricade all'interno dell'anno in cui lo script è stato caricato per l'ultima volta e restituisce True in caso affermativo e False in caso negativo.
yeartodate(date [ , yearoffset [ , firstmonth [ , todaydate] ] ])
Funzioni timezone
Questa funzione restituisce il fuso orario impostato sul computer dove è in esecuzione il motore Qlik.
timezone( )
Questa funzione restituisce il valoreGreenwich Mean Timeattuale ricavato dalle impostazioni locali.
GMT( )
Restituisce il Coordinated Universal Time attuale.
UTC( )
Restituisce il valore di regolazione attuale per l'ora legale, come definito in Windows.
Converte un indicatore temporale UTC o GMT in ora locale come valore duale. Il luogo può essere qualsiasi città, località o fuso orario nel mondo.
converttolocaltime(timestamp [, place [, ignore_dst=false]])
Funzioni set time
Questa funzione utilizza come input un timestamp e un year e aggiorna il timestamp con l'year specificato nell'input.
setdateyear (timestamp, year)
Questa funzione utilizza come input un timestamp, un month e un year e aggiorna il timestamp con l'year e il month specificati nell'input.
setdateyearmonth (timestamp, year, month)
Funzioni in...
Questa funzione restituisce True se timestamp ricade all'interno dell'anno contenente base_date.
inyear(date, basedate , shift [, first_month_of_year = 1])
Questa funzione restituisce True se timestamp ricade all'interno della parte dell'anno contenente base_date fino a includere l'ultimo millisecondo di base_date.
inyeartodate (date, basedate , shift [, first_month_of_year = 1])
Questa funzione restituisce True se timestamp ricade all'interno del trimestre contenente base_date.
inquarter (date, basedate , shift [, first_month_of_year = 1])
Questa funzione restituisce True se timestamp ricade all'interno della parte del trimestre contenente base_date fino a includere l'ultimo millisecondo di base_date.
inquartertodate (date, basedate , shift [, first_month_of_year = 1])
Questa funzione restituisce True se timestamp ricade all'interno del mese contenente base_date.
inmonth(date, basedate , shift)
Restituisce True se date ricade nella parte di mese contenente basedate fino a includere l'ultimo millisecondo di basedate.
inmonthtodate (date, basedate , shift)
Questa funzione consente di verificare se un indicatore temporale cade nello stesso mese, bimestre, trimestre, quadrimestre o semestre di una data base. È inoltre possibile stabilire se l'indicatore temporale ricade all'interno di un periodo di tempo precedente o successivo.
inmonths(n, date, basedate , shift [, first_month_of_year = 1])
Questa funzione stabilisce se un indicatore temporale ricade all'interno della parte di un periodo di un mese, bimestre, trimestre, quadrimestre o semestre fino a includere l'ultimo millisecondo di base_date. È inoltre possibile stabilire se l'indicatore temporale ricade all'interno di un periodo di tempo precedente o successivo.
inmonthstodate (n, date, basedate , shift [, first_month_of_year = 1])
Questa funzione restituisce True se timestamp ricade all'interno della settimana contenente base_date.
inweek(date, basedate , shift [, weekstart])
Questa funzione restituisce True se timestamp ricade all'interno della parte della settimana contenente base_date fino a includere l'ultimo millisecondo di base_date.
inweektodate (date, basedate , shift [, weekstart])
Questa funzione determina se timestamp ricade all'interno della settimana lunare contenente base_date. Le settimane lunari in Qlik Sense sono definite contando il 1° gennaio come primo giorno della settimana, a parte l'ultima settimana dell'anno, ogni settimana conterrà esattamente sette giorni.
inlunarweek (date, basedate , shift [, weekstart])
Questa funzione stabilisce se timestamp ricade all'interno della parte della settimana lunare fino a includere l'ultimo millisecondo di base_date. Le settimane lunari in Qlik Sense sono definite contando il 1° gennaio come primo giorno della settimana e, a parte l'ultima settimana dell'anno, conterranno esattamente sette giorni.
inlunarweektodate (date, basedate , shift [, weekstart])
Questa funzione restituisce True se timestamp ricade all'interno del giorno contenente base_timestamp.
inday(timestamp, basetimestamp , shift [, daystart])
Questa funzione restituisce True se timestamp ricade nella parte del giorno contenente base_timestamp fino a includere il millisecondo esatto di base_timestamp.
indaytotime(timestamp, basetimestamp , shift [, daystart])
Funzioni start ... end
Questa funzione restituisce un indicatore temporale corrispondente all'inizio del primo giorno dell'anno contenente date. Il formato di output predefinito sarà il formato DateFormat impostato nello script.
yearstart( date [, shift = 0 [, first_month_of_year = 1]])
Questa funzione restituisce un valore corrispondente a un indicatore temporale recante l'ultimo millisecondo dell'ultimo giorno dell'anno contenente date. Il formato di output predefinito sarà il formato DateFormat impostato nello script.
yearend( date [, shift = 0 [, first_month_of_year = 1]])
Questa funzione restituisce un anno di quattro cifre come valore di visualizzazione con un valore numerico sottostante corrispondente a un indicatore temporale recante il primo millisecondo del primo giorno dell'anno contenente date.
yearname(date [, shift = 0 [, first_month_of_year = 1]] )
Questa funzione restituisce un valore corrispondente a un indicatore temporale recante il primo millisecondo del trimestre contenente date. Il formato di output predefinito sarà il formato DateFormat impostato nello script.
quarterstart(date [, shift = 0 [, first_month_of_year = 1]])
Questa funzione restituisce un valore corrispondente a un indicatore temporale recante l'ultimo millisecondo del trimestre contenente date. Il formato di output predefinito sarà il formato DateFormat impostato nello script.
quarterend(date [, shift = 0 [, first_month_of_year = 1]])
Questa funzione restituisce un valore di visualizzazione che mostra i mesi del trimestre (formattati in base alla variabile di script MonthNames) e l'anno con valore numerico sottostante corrispondente a un indicatore temporale recante il primo millisecondo del primo giorno del trimestre.
quartername(date [, shift = 0 [, first_month_of_year = 1]])
Questa funzione restituisce un valore corrispondente a un indicatore temporale recante il primo millisecondo del primo giorno del mese contenente date. Il formato di output predefinito sarà il formato DateFormat impostato nello script.
monthstart(date [, shift = 0])
Questa funzione restituisce un valore corrispondente a un indicatore temporale recante l'ultimo millisecondo dell'ultimo giorno del mese contenente date. Il formato di output predefinito sarà il formato DateFormat impostato nello script.
monthend(date [, shift = 0])
Questa funzione restituisce un valore di visualizzazione che mostra il mese (formattato in base alla variabile di script MonthNames) e l'anno il cui valore numerico sottostante corrisponde a un indicatore temporale recante il primo millisecondo del primo giorno del mese.
monthname(date [, shift = 0])
Questa funzione restituisce un valore corrispondente a un indicatore temporale recante il primo millisecondo del mese, del bimestre, del trimestre, del quadrimestre o del semestre contenente una data di base. È inoltre possibile individuare l'indicatore temporale per un periodo di tempo precedente o successivo.Il formato di output predefinito è il formato DateFormat impostato nello script.
monthsstart(n, date [, shift = 0 [, first_month_of_year = 1]])
Questa funzione restituisce un valore corrispondente a un indicatore temporale recante l'ultimo millisecondo del mese, del bimestre, del trimestre, del quadrimestre o del semestre contenente una data di base. È inoltre possibile individuare l'indicatore temporale per un periodo di tempo precedente o successivo.
monthsend(n, date [, shift = 0 [, first_month_of_year = 1]])
Questa funzione restituisce un valore di visualizzazione che rappresenta l'intervallo dei mesi del periodo (formattati in base alla variabile di script MonthNames) e l'anno. Il valore numerico sottostante corrisponde a un indicatore temporale recante il primo millisecondo del mese, del bimestre, del trimestre, del quadrimestre o del semestre contenente una data di base.
monthsname(n, date [, shift = 0 [, first_month_of_year = 1]])
Questa funzione restituisce un valore corrispondente a un indicatore temporale recante il primo millisecondo del primo giorno della settimana di calendario contenente date. Il formato di output predefinito è il formato DateFormat impostato nello script.
weekstart(date [, shift = 0 [,weekoffset = 0]])
Questa funzione restituisce un valore corrispondente a un indicatore temporale recante l'ultimo millisecondo dell'ultimo giorno della settimana lunare contenente date. Il formato di output predefinito sarà il formato DateFormat impostato nello script.
weekend(date [, shift = 0 [,weekoffset = 0]])
Questa funzione restituisce un valore che mostra l'anno e il numero della settimana con un valore numerico sottostante corrispondente a un indicatore temporale recante il primo millisecondo del primo giorno della settimana contenente date.
weekname(date [, shift = 0 [,weekoffset = 0]])
Questa funzione restituisce un valore corrispondente a un indicatore temporale del primo millisecondo del primo giorno della settimana lunare contenente date. Le settimane lunari in Qlik Sense sono definite contando il 1° gennaio come primo giorno della settimana e, a parte l'ultima settimana dell'anno, conterranno esattamente sette giorni.
lunarweekstart(date [, shift = 0 [,weekoffset = 0]])
Questa funzione restituisce un valore corrispondente a un indicatore temporale recante l'ultimo millisecondo dell'ultimo giorno della settimana lunare contenente date. Le settimane lunari in Qlik Sense sono definite contando il 1° gennaio come primo giorno della settimana e, a parte l'ultima settimana dell'anno, conterranno esattamente sette giorni.
lunarweekend(date [, shift = 0 [,weekoffset = 0]])
Questa funzione restituisce un valore di visualizzazione che mostra l'anno e il numero della settimana lunare corrispondente a un indicatore temporale del primo millisecondo del primo giorno della settimana lunare contenente date. Le settimane lunari in Qlik Sense sono definite contando il 1° gennaio come primo giorno della settimana e, a parte l'ultima settimana dell'anno, conterranno esattamente sette giorni.
lunarweekname(date [, shift = 0 [,weekoffset = 0]])
Questa funzione restituisce un valore corrispondente a un indicatore temporale con il primo millisecondo del giorno contenuto nell'argomento time. Il formato di output predefinito sarà il formato TimestampFormat impostato nello script.
daystart(timestamp [, shift = 0 [, dayoffset = 0]])
Questa funzione restituisce un valore corrispondente a un indicatore temporale dell'ultimo millisecondo del giorno contenuto in time. Il formato di output predefinito sarà il formato TimestampFormat impostato nello script.
dayend(timestamp [, shift = 0 [, dayoffset = 0]])
Questa funzione restituisce un valore che mostra la data con un valore numerico sottostante corrispondente a un indicatore temporale recante il primo millisecondo del giorno contenente time.
dayname(timestamp [, shift = 0 [, dayoffset = 0]])
Funzioni di numerazione del giorno
La funzione age restituisce l'età al momento dell'indicazione della data e dell'ora timestamp (in anni completi) di un soggetto nato nella data date_of_birth.
age(timestamp, date_of_birth)
La funzione networkdays restituisce il numero di giorni lavorativi (dal lunedì al venerdì) compresi tra e inclusi in start_date e end_date, tenendo in considerazione qualsiasi eventuale valore di festività holiday nel calendario.
networkdays (start:date, end_date {, holiday})
La funzione firstworkdate restituisce la data di inizio più recente per fare in modo che il valore no_of_workdays (dal lunedì al venerdì) non termini oltre la data end_date, tenendo in considerazione tutte le festività eventualmente in calendario. end_date e holiday devono essere date o indicatori temporali validi.
firstworkdate(end_date, no_of_workdays {, holiday} )
La funzione lastworkdate restituisce la data di fine più prossima per ottenere no_of_workdays (dal lunedì al venerdì) se si inizia dalla data start_date tenendo in considerazione tutte le festività holiday eventualmente in calendario. start_date e holiday devono essere date o indicatori temporali validi.
lastworkdate(start_date, no_of_workdays {, holiday})
Questa funzione calcola il numero del giorno dell'anno a cui è stato assegnato un indicatore temporale. Il calcolo viene eseguito partendo dal primo millisecondo del primo giorno dell'anno, tuttavia il primo mese può essere differito.
daynumberofyear(date[,firstmonth])
Questa funzione calcola il numero del giorno del trimestre a cui è stato assegnato un indicatore temporale. Questa funzione viene utilizzata al momento di creare un Calendario principale.
daynumberofquarter(date[,firstmonth])