Funzioni data e ora
Di seguito è riportato un elenco di funzioni data e ora utilizzabili nelle espressioni.
Funzione | Descrizione |
---|---|
DateAdd(Arg1, Arg2, Arg3) | Aggiunge un intervallo a Date,Time o DateTime. Il metodo può aggiungere un TimeSpan o un Integer che rappresenta una parte di data o di ora specificata (ad esempio il numero di giorni). Se deve essere aggiunto un TimeSpan sono necessari due argomenti: una colonna DateTime e una colonna TimeSpan. Se deve essere aggiunto un intero a una parte di data o ora, vengono utilizzati tre argomenti:Arg1 è una stringa che descrive la parte da aggiungere.Arg2 è un numero che contiene il numero di parti da aggiungere.Arg3 è la colonna Date, Time o DateTime. Gli argomenti validi per Arg1 sono: 'year' o 'yy' - L'anno. 'quarter' o 'qq' - Il trimestre. 'month' o 'mm' - Il mese. 'day' o 'dd' - Il giorno. 'week' o 'wk' - La settimana. 'hour' o 'hh' - L'ora. 'minute' o 'mi' - Il minuto. 'second' o 'ss' - Il secondo. 'millisecond' o 'ms' - Il millisecondo. Esempi: DateAdd([Date Column], [TimeSpan Column]) DateAdd('year', 2, [Date Column]) DateAdd('month', 1, [Date Column]) |
DateDiff(Arg1, Arg2, Arg3) | Calcola la differenza tra due colonne Date, Time o DateTime. Il risultato è presentato come TimeSpan o come valore real che rappresenta una parte di tempo specificata (ad esempio il numero di giorni). In caso di due argomenti (una colonna data di inizio e una colonna data di fine), il risultato è un valore TimeSpan che mostra la differenza totale. In caso di tre argomenti, il primo argomento deve essere la parte da confrontare. Il secondo argomento è la colonna data di inizio e il terzo argomento è la colonna data di fine. Il risultato dell'operazione è un valore di tipo real. Gli argomenti validi per Arg1 sono: 'year' o 'yy' - L'anno. 'quarter' o 'qq' - Il trimestre. 'month' o 'mm' - Il mese. 'day' o 'dd' - Il giorno. 'week' o 'wk' - La settimana. 'hour' o 'hh' - L'ora. 'minute' o 'mi' - Il minuto. 'second' o 'ss' - Il secondo. 'millisecond' o 'ms' - Il millisecondo. Esempio: DateDiff([Order Date], [Delivery Date]) DateDiff('day', [Order Date], [Delivery Date]) Per gli esempio, vedere Calcoli delle differenze temporali e Calcolo dei periodi di tempo. |
DatePart(Arg1, Arg2) | Restituisce una parte specificata di Date, Time o DateTime. Arg1 è una stringa che descrive quale parte della data va considerato e Arg2 è la colonna Date, Time o DateTime. Gli argomenti validi per Arg1 sono: 'year' o 'yy' - L'anno. 'quarter' o 'qq' - Il trimestre. 'month' o 'mm' - Il mese. 'day of year' o 'dy' - Il giorno dell'anno. 'day' o 'dd' - Il giorno. 'year and week' o 'yywk' - L'anno e la settimana. 'week' o 'wk' - La settimana. 'day of week' o 'dw' - Il giorno della settimana. 'hour' o 'hh' - L'ora. 'minute' o 'mi' - Il minuto. 'second' o 'ss' - Il secondo. 'millisecond' o 'ms' - Il millisecondo. Esempio: DatePart('year', [Date Column]) |
DateTimeNow() | Restituisce l'ora di sistema corrente. Esempio: DateTimeNow() Per gli esempio, vedere Calcoli delle differenze temporali e Calcolo dei periodi di tempo. |
Day(Arg1) | Estrae il giorno del mese da una colonna Date o DateTime. Il risultato è un intero tra 1 e 31. Esempio: Day([Date Column]) |
DayOfMonth(Arg1) | Estrae il giorno del mese da una colonna Date o DateTime. Il risultato è un intero tra 1 e 31. Esempio: DayOfMonth([Date Column]) |
DayOfWeek(Arg1) | Estrae il giorno della settimana da una colonna Date o DateTime. I dati sottostanti della nuova colonna sono un numero intero tra 0 (Domenica) e 6 (Sabato), ma l'inizio della settimana è determinato dalle impostazioni regionali, così come il risultato formattato della nuova colonna. Esempio: DayOfWeek([Date Column]) |
DayOfYear(Arg1) | Estrae il giorno dell'anno da una colonna Date o DateTime. Restituisce un numero intero compreso tra 1 e 366. Esempio: DayOfYear([Date Column]) |
Days(Arg1) | Restituisce il numero di giorni per un TimeSpan, come valore Integer compreso tra -10675199 e 10675199. Oppure, se l'argomento è un valore Integer, crea una colonna TimeSpan in cui l'input è il numero di giorni. Esempi: Days([TimeSpan Column]) Days(3) |
FiscalMonth(Arg1, Arg2) | Restituisce il mese fiscale per una data. Il primo argomento è la colonna Date. Il secondo argomento (facoltativo) è il numero di mesi per lo spostamento. Se non viene specificato un secondo argomento, verrà utilizzato il valore della proprietà del documento FiscalYearOffset. Le impostazioni regionali determinano il risultato formattato. Quando viene utilizzato nelle gerarchie, il metodo FiscalMonth tiene traccia dell'ordinamento dei mesi in modo che gli elementi della visualizzazione vengano visualizzati nel giusto ordine. Ad esempio, se l'anno fiscale termina a gennaio, l'anno fiscale successivo deve iniziare con febbraio, come mostrato di seguito, e non con gennaio: La gerarchia nell'immagine è stata creata utilizzando l'espressione seguente: <FiscalYear([Date Column],1) NEST FiscalMonth([Date Column],1)> Esempi: FiscalMonth([Date Column], 1) FiscalMonth([Date Column]) |
FiscalQuarter (Arg1, Arg2) | Restituisce il trimestre fiscale relativo a una data (Arg1), sulla base dello spostamento specificato in mesi (Arg2). Il secondo argomento è facoltativo. Se non viene specificato un secondo argomento, verrà utilizzato il valore della proprietà del documento FiscalYearOffset. Esempi: FiscalQuarter([Date Column], 1) FiscalQuarter([Date Column]) |
FiscalYear (Arg1, Arg2) | Restituisce l'anno fiscale relativo a una data (Arg1), sulla base dello spostamento specificato in mesi (Arg2). Il secondo argomento è facoltativo. Se non viene specificato un secondo argomento, verrà utilizzato il valore della proprietà del documento FiscalYearOffset. Esempi: FiscalYear([Date Column], 1) FiscalYear([Date Column]) |
Hour(Arg1) | Estrae l'ora da una colonna DateTime oppure Time. Restituisce un numero intero compreso tra 0 e 23. Esempio: Hour([Time Column]) |
Hours(Arg1) |
Restituisce il numero di ore per un TimeSpan, come valore Integer compreso tra 0 e 23. Oppure, se l'argomento è un valore Integer, crea una colonna TimeSpan in cui l'input è il numero di ore. Esempi: Hours([TimeSpan Column]) Hours(10) |
Millisecond(Arg1) |
Estrae i millisecondi da una colonna DateTime oppure Time. Restituisce un numero intero compreso tra 0 e 999. Esempio: Millisecond([Time Column]) |
Milliseconds(Arg1) |
Restituisce il numero di millisecondi per un TimeSpan, come valore Real compreso tra 0,0 e 999,0. Oppure, se l'argomento è un valore Real, crea una colonna TimeSpan in cui l'input è il numero di millisecondi. Esempi: Milliseconds([TimeSpan Column]) Milliseconds(123.45) |
Minute(Arg1) | Estrae il minuto da una colonna DateTime oppure Time. Restituisce un numero intero compreso tra 0 e 59. Esempio: Minute([Time Column]) |
Minutes(Arg1) |
Restituisce il numero di minuti per un TimeSpan, come valore Integer compreso tra 0 e 59. Oppure, se l'argomento è un valore Integer, crea una colonna TimeSpan in cui l'input è il numero di minuti. Esempi: Minutes([TimeSpan Column]) Minutes(50) |
Month(Arg1) | Estrae il mese da una colonna Date oppure DateTime. I dati sottostanti della nuova colonna sono un numero intero tra 1 e 12, anche se le impostazioni regionali determinano il risultato formattato della nuova colonna. Esempio: Month([Date Column]) |
Quarter(Arg1) | Estrae il trimestre da una colonna Date oppure DateTime. I dati sottostanti della nuova colonna sono un numero intero tra 1 e 4, anche se le impostazioni regionali determinano il risultato formattato della nuova colonna. Esempio: Quarter([Date Column]) |
Second(Arg1) | Estrae il secondo da una colonna DateTime oppure Time. Restituisce un numero intero compreso tra 0 e 59. Esempio: Second([Time Column]) |
Seconds(Arg1) | Restituisce il numero di secondi per un TimeSpan, come valore Integer compreso tra 0 e 59. Oppure, se l'argomento è un valore Integer, crea una colonna TimeSpan in cui l'input è il numero di secondi. Esempi: Seconds([TimeSpan Column]) Seconds(10) |
Today() | Restituisce la data corrente. Esempio: Today() |
TotalDays(Arg1) | Restituisce il numero di giorni per un TimeSpan, come valore real espresso in giorni interi e frazionari. Esempio: TotalDays([TimeSpan Column]) |
TotalHours(Arg1) | Restituisce il numero di ore per un TimeSpan, come valore real espresso in ore intere e frazionarie. Esempio: TotalHours([TimeSpan Column]) |
TotalMilliseconds(Arg1) | Restituisce il numero di millisecondi per un TimeSpan, come valore real espresso in millisecondi interi e frazionari. Esempio: TotalMilliseconds([TimeSpan Column]) |
TotalMinutes(Arg1) | Restituisce il numero di minuti per un TimeSpan, come valore real espresso in minuti interi e frazionari. Esempio: TotalMinutes([TimeSpan Column]) |
TotalSeconds() | Restituisce il numero di secondi per un TimeSpan, come valore real espresso in secondi interi e frazionari. Esempio: TotalSeconds([TimeSpan Column]) |
Week(Arg1) | Estrae la settimana da una colonna Date o DateTime, come numero intero compreso tra 1 e 54, dove la prima settimana dell'anno dipende dalle impostazioni regionali. Esempio: Week([Date Column]) |
Year(Arg1) | Estrae l'anno da una colonna Date oppure DateTime. Il risultato è di tipo Integer. Esempio: Year([Date Column]) |
YearAndWeek(Arg1) | Estrae l'anno e la settimana da una colonna Date oppure DateTime. Restituisce un Integer (anno*100 + numero settimana), ad esempio la data 13-10-2005 restituisce 200541. Esempio: YearAndWeek([Date Column]) |