Le funzioni data e ora di QlikView consentono di trasformare e convertire i valori di data e ora. Tutte le funzioni possono essere utilizzate sia nello script di caricamento 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.
QlikView 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, QlikView 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, QlikView 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 data e ora hh:mm:ss e YYYY-MM-DD (ISO 8601).
Quando elabora un valore di data e ora con una funzione data o ora, QlikView 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 di esse. 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(timestamp [, first_week_day [, broken_weeks [, reference_day]]])
Questa funzione restituisce un valore duale con 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 interpretata 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 recante l'ora attuale fornita dall'orologio di sistema. Il valore predefinito è 1.
now([ timer_mode])
Questa funzione restituisce la data attuale fornita dall'orologio di sistema.
today([timer_mode])
Questa funzione restituisce un indicatore temporale dell'ora attuale fornita dall'orologio di sistema per un 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 la data 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(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])
Funzioni timezone
Questa funzione restituisce il nome del fuso orario corrente come definito in Windows, senza tenere in considerazione la regolazione per l'ora legale.
timezone( )
Questa funzione restituisce la data e l'ora Greenwich Mean Time corrente fornita dall'orologio di sistema e dalle impostazioni dell'ora di Windows.
GMT( )
Restituisce la data e l'ora Coordinated Universal Time corrente.
UTC( )
Restituisce il valore di regolazione attuale per l'ora legale, come definito in Windows.
Converte un'indicazione di data e ora UTC o GMT in ora locale come valore duale. La posizione può essere qualsiasi città o fuso orario nel mondo.
converttolocaltime(timestamp [, place [, ignore_dst=false]])
Funzioni set time
Questa funzione acquisisce come input un timestamp e un year e aggiorna il timestamp con year specificato nell'input.
setdateyear (timestamp, year)
Questa funzione acquisisce come input un timestamp, un month e un year e aggiorna il timestamp con year e 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 timestamp ricade nella parte di mese contenente base_date fino a includere l'ultimo millisecondo di base_date.
inmonthtodate (date, basedate , shift)
Questa funzione consente di verificare se un'indicazione di data e ora ricade nello stesso mese, bimestre, trimestre, quadrimestre o semestre di una data base. È inoltre possibile stabilire se l'indicazione di data e ora ricade all'interno di un periodo di tempo precedente o successivo.
inmonths(n, date, basedate , shift [, first_month_of_year = 1])
Questa funzione consente di verificare se un'indicazione di data e ora 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'indicazione di data e ora 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 restituisce true se timestamp ricade all'interno della settimana lunare contenente base_date. Le settimane lunari in QlikView vengono definite calcolando il 1° gennaio come primo giorno della settimana.
inlunarweek (date, basedate , shift [, weekstart])
Questa funzione restituisce true se timestamp ricade all'interno della parte della settimana lunare fino a includere l'ultimo millisecondo di base_date. Le settimane lunari in QlikView vengono definite calcolando il 1° gennaio come primo giorno della settimana.
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.
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 l'ultimo 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 (lunedì) 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 dell'ultimo millisecondo dell'ultimo giorno (domenica) della settimana di calendario 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 della settimana lunare contenente date. Le settimane lunari in QlikView vengono definite calcolando il 1° gennaio come primo giorno della settimana.
lunarweekstart(date [, shift = 0 [,weekoffset = 0]])
Questa funzione restituisce un valore corrispondente a un indicatore temporale recante l'ultimo millisecondo della settimana lunare contenente date. Le settimane lunari in QlikView vengono definite calcolando il 1° gennaio come primo giorno della settimana.
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 QlikView vengono definite calcolando il 1° gennaio come primo giorno della settimana.
lunarweekname(date [, shift = 0 [,weekoffset = 0]])
Questa funzione restituisce un valore corrispondente a un'indicazione di data e ora 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.
daynumberofquarter(date[,firstmonth])
