Funzioni Data e ora
Una funzione Data e ora esegue un'azione o un calcolo su un valore di data e ora. Usa una funzione Data e ora per aggiungere o sottrarre intervalli, trovare la data corrente, trovare il primo o l'ultimo giorno del mese, estrarre un componente di un valore Data e ora o convertire un valore in un formato diverso.
Supporto data
Designer non è in grado di elaborare le date precedenti al 1° gennaio 1400.
Alteryx utilizza il formato ISO yyyy-mm-dd HH:MM:SS per rappresentare date e ore. Per una maggiore precisione (fino a 18 cifre di precisione) aggiungere un punto e altre cifre dopo la posizione dei secondi. Ad esempio,
AAAA-mm-gg HH:MM:SS.5
. Se un valore Data e ora non è in questo formato, Alteryx lo legge come stringa. Per convertire una colonna per l'utilizzo e la modifica nel formato Data e ora, utilizza la funzione DateTimeParse nell'editor delle espressioni o
nello strumento Data e ora
.
Alcune funzioni Data e ora richiedono l'impostazione del formato della data. Le stringhe di formato sono costituite da identificatori e separatori.
Parole chiave per unità data-ora
Queste parole chiave sono compatibili con le funzioni DateTimeAdd, DateTimeDiff e DateTimeTrim. Le parole chiave non distinguono tra maiuscole e minuscole. Le parole chiave accettate per ciascuna unità sono separate da virgole.
In alcuni casi, si accettano abbreviazioni fino alla parola chiave completa. Queste sono specificate con
fino a
nell'elenco seguente e vanno dall'abbreviazione più breve accettabile alla parola chiave completa. Per esempio, per secondi accettiamo
sec
e
secondi
, così come qualsiasi cosa intermedia, come
seco
. Le parole chiave sono in inglese e la traduzione in altre lingue non è supportata.
È inoltre possibile utilizzare valori numerici come parole chiave per un tempo inferiore ai secondi. Sono incluse le unità non espressamente indicate nell'elenco riportato di seguito. Ad esempio, è possibile utilizzare la parola chiave "10" per indicare 10 cifre di precisione.
yea upto yearsmon upto monthsday, dayshou upto hoursmin upto minutessec upto secondsds, dsec, dsecs, deciseconds, 1cs, csec, csecs, centiseconds, 2ms, msec, msecs, milliseconds, 3us, usec, usecs, microseconds, 6ns, nsec, nsecs, nanoseconds, 9ps, psec, psecs, picoseconds, 12fs, fsec, fsecs, femtoseconds, 15as, asec, asecs, attoseconds, 18
Per alcuni esempi delle dimensioni del campo DateTime con varie unità di precisione, fai riferimento alla seguente tabella:
Nome | Abbreviazione | Dimensione DateTime | Esempio |
|---|---|---|---|
Secondi |
| 19 (opzione predefinita) | 2023-02-24 01:23:45 |
Decisecondi (1) |
| 21 (19 + 1 + 1) | 2023-02-24 01:23:45.1 |
Centosecondi (2) |
| 22 (19 + 1 + 2) | 2023-02-24 01:23:45.12 |
Millisecondi (3) |
| 23 (19 + 1 + 3) | 2023-02-24 01:23:45.123 |
Microsecondi (6) |
| 26 (19 + 1 + 6) | 2023-02-24 01:23:45.123456 |
Nanosecondi (9) |
| 29 (19 + 1 + 9) | 2023-02-24 01:23:45.123456789 |
Picosecondi (12) |
| 32 (19 + 1 + 12) | 2023-02-24 01:23:45.123456789012 |
Femtosecondi (15) |
| 35 (19 + 1 + 15) | 2023-02-24 01:23:45.123456789012345 |
Attosecondi (18) |
| 38 (19 + 1 + 18) | 2023-02-24 01:23:45.123456789012345678 |
Identificatori
Gli identificatori iniziano sempre con un segno di percentuale (%), seguito da una lettera con distinzione tra maiuscole e minuscole. I dati devono includere almeno un anno a due cifre.
Identificatore | Output da DateTimeFormat | Input supportato con DateTimeParse |
|---|---|---|
| Il numero di cifre di precisione per i sottosecondi. | Fino a 18 cifre di precisione per sottosecondi. |
| Nome abbreviato del giorno della settimana ("lun") | Qualsiasi abbreviazione valida di un giorno della settimana ("lun", "mar.", "gio"). Restituisce un errore solo se il testo fornito non è un giorno della settimana. Nota che Alteryx non controlla che il nome del giorno specificato sia valido per una data specifica. |
| Nome completo del giorno della settimana ("lunedì") | Nome del giorno o qualsiasi abbreviazione valida di un giorno della settimana ("lun", "mar.", "gio"). Restituisce un errore solo se il testo fornito non è un giorno della settimana. Nota che Alteryx non controlla che il nome del giorno specificato sia valido per una data specifica. |
| Nome abbreviato del mese ("set") | Qualsiasi abbreviazione valida del nome di un mese ("Set", "SET."). Restituisce un errore solo se il testo specificato non è un nome di un mese. |
| Nome completo del mese ("settembre") | Nome del mese o qualsiasi abbreviazione valida del nome di un mese ("Set", "SET."). Restituisce un errore solo se il testo specificato non è un nome di un mese. |
| La data e l'ora delle impostazioni locali del computer. | Non supportato |
| Numero del secolo ("20") | Non supportato |
| Giorno del mese ("01") | Una o due cifre, ignorando gli spazi ("1" o "01"). |
| Equivalente a %m/%d/%y | Non supportato |
| Giorno del mese, 0 iniziale sostituito da uno spazio (" 1"). | Una o due cifre, ignorando gli spazi ("1" o "01"). |
| Uguale a %b ("set") | Qualsiasi abbreviazione valida del nome di un mese ("Set", "SET."). Restituisce un errore solo se il testo specificato non è un nome di un mese. |
| Ora nel formato 24 ore, da 00 a 23. | Fino a due cifre per l'ora, da 0 a 23. Non compatibile con %p o %P. |
| Ora nel formato 12 ore, da 01 a 12. | Fino a due cifre per l'ora, da 1 a 12. Deve essere seguito da %p o %P. |
| Il giorno dell'anno, da 001 a 365 (o 366 negli anni bisestili) | Giorno dell'anno a 3 cifre, da 001 a 365 (o 366 negli anni bisestili) |
| 24 ore, lo zero iniziale è lo spazio, da " 0" a "23". | Fino a due cifre per l'ora. |
| 12 ore, lo zero iniziale è lo spazio, da " 1" a "12". | Non supportato |
| Minuti, da 00 a 59 minuti | Fino a due cifre per i minuti. |
| Numero del mese, da 01 a 12. | Numero del mese a una o due cifre, da 1 o 01 a 12. |
| "AM" o "PM" | Caso cieco ("aM" o "Pm"). Deve seguire %I ("i" maiuscola, ora in formato 12 ore). |
| "am" o "pm" | Caso cieco ("aM" o "Pm"). Deve seguire %I ("i" maiuscola, ora in formato 12 ore). |
| Secondi, da 00 a 59 | Fino a due cifre per i secondi. |
| Tempo in notazione a 24 ore. Equivalente a %H:%M:%S | Non supportato |
| Giorno della settimana come decimale, da 1 a 7, con lunedì come 1. | Non supportato |
| Restituisce il numero della settimana, come 00 – 53, con l'inizio delle settimane come domenica. | Non supportato |
| Giorno della settimana come numero, da 0 a 6, con domenica come 0. | Non supportato |
| Restituisce il numero della settimana, come 00 – 53, con l'inizio delle settimane come lunedì. | Non supportato |
| La data delle impostazioni locali del computer. | Non supportato |
| L'ora nel formato 12 ore, incluse le specifiche AM o PM ("11:51:02 AM"). | Hours:Minutes:Seconds [AM / PM] |
| Ultime due cifre dell'anno ("16"). | Vengono lette fino a quattro cifre, interrompendo l'operazione in corrispondenza di un separatore o alla fine della stringa e vengono mappate a un intervallo dell'anno corrente sottraendo 66 e sommando 33. Ad esempio, nel 2016, tra 1950 e 2049. Limitazione con date a sei cifre Poiché per l'anno vengono lette fino a quattro cifre, i formati con due sole cifre senza separatore, come un indicatore di data a sei cifre (ad esempio %y%m%d per i dati simili a 170522 per il 22 maggio 2017), vengono comunque letti come quattro cifre. Per aggirare questa limitazione, è possibile:
|
| Tutte e quattro le cifre dell'anno ("2016"). | Vengono lette due o quattro cifre. Due cifre vengono mappate a un intervallo dell'anno corrente sottraendo 66 e sommando 33. Ad esempio, nel 2016, tra 1950 e 2049. |
| Offset dall'ora UTC ("-600"). | Non supportato |
| Nome completo del fuso orario ("Ora legale fuso occidentale"). | Non supportato |
Separatori
I separatori vengono inseriti tra gli identificatori Data e Ora per formare una stringa di formato.
Separatore | Output da DateTimeFormat | Input supportato con DateTimeParse |
|---|---|---|
| / | / o - |
| - | / o - |
space | Uno spazio | Qualsiasi sequenza di spazi vuoti. |
| Una nuova riga | Non supportato |
| Una scheda | Non supportato |
Altro | Altri caratteri, ad esempio virgola, punto e due punti. | Altri caratteri, ad esempio virgola, punto e due punti. |
*DateTimeParse accetta indifferentemente le barre (/) e i trattini (-). Tuttavia, le virgole, i due punti e tutti gli altri separatori devono corrispondere esattamente ai dati in ingresso.
Parametri lingua
Si tratta dei valori compatibili per il parametro "l" (lingua) supportati con le funzioni DateTimeFormat e DateTimeParse .
Nome lingua inglese | Nome lingua di origine | Codice lingua |
|---|---|---|
Inglese | Inglese | en |
Italiano | Italiano | it |
Francese | Francese | fr |
Tedesco | Tedesco | de |
Giapponese | Giapponese | ja |
Spagnolo | Spagnolo | es |
Portoghese | Portoghese | pt |
Cinese | 简体中文 | zh |
Oltre ai valori di cui sopra, sono accettabili anche i valori con almeno 2 caratteri che iniziano con uno qualsiasi dei valori precedenti. Ad esempio, eng, engl, engli, ecc. per inglese o esp, espa, sp, spa, span, ecc. per spagnolo/español.
Funzioni Data e ora
Fai riferimento alle funzioni DateTime riportate di seguito.
DateTimeAdd
DateTimeAdd(dt,i,u)
: aggiunge un intervallo specifico a un valore data-ora.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
i
: numero intero positivo o negativo di tempo da aggiungere o sottrarre.
u
: unità data-ora, specificata tra virgolette utilizzando le parole chiave elencate nella sezione
Parole chiave per unità data-ora.
.
Esempio
DateTimeAdd(DateTimeToday(), -1, "days")
restituisce la data di ieri.
DateTimeAdd(DateTimeFirstOfMonth(), 1, "months")
restituisce il primo del mese successivo.
DateTimeAdd("2016-01-30", 1, "month")
restituisce 2016-02-29 (perché febbraio non ha 30 giorni, ma l'ultimo giorno nell'anno indicato è il 29).
DateTimeAdd("2016-03-30", -1, "month")
restituisce 2016-02-29 (perché febbraio non ha 30 giorni, ma l'ultimo giorno nell'anno indicato è il 29).
DateTimeAdd("2016-03-30 01:02:03.000000", 495, "microseconds")
restituisce il 2016-03-30 01:02:03.000495.
Più informazioni
Qualsiasi frazione della durata viene troncata. Ad esempio, non è possibile aggiungere "1,5 ore". Aggiungi invece "90 minuti".
L'aggiunta di un'unità non modifica il valore delle unità più piccole. Ad esempio, l'aggiunta di ore non modifica il valore di minuti o secondi. L'aggiunta di mesi non modifica il giorno o l'ora, a meno che il mese risultante non avrebbe tale giorno. In questo caso, si va all'ultimo giorno di quel mese.
DateTimeDay
DateTimeDay(dt)
: restituisce il valore numerico del giorno del mese in un valore data e ora.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
Esempio
DateTimeDay("2017-03-24 11:43:23")
restituisce 24.
DateTimeDiff
DateTimeDiff(dt1,dt2,u)
: sottrae il secondo argomento dal primo e lo restituisce come differenza intera. La durata viene restituita come numero, non come stringa, nelle unità di tempo specificate.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
u
: unità data-ora, specificata tra virgolette utilizzando parole chiave dalla sezione
Parole chiave per unità data-ora
.
Esempio
DateTimeDiff("2016-02-15 00:00:00", "2016-01-15 00:00:01", "Months")
restituisce 1 (perché l'inizio e la fine coincidono con lo stesso giorno del mese).
DateTimeDiff("2012-02-29","2011-03-01","years")
restituisce 0 (anche se la data 2012-02-29 cade 365 giorni dopo 2011-03-01, il 29 febbraio è prima del 1° marzo, quindi "un anno" non è ancora trascorso completamente).
DateTimeDiff("2016-02-14", "2016-01-15", "Months")
restituisce 0 (perché il giorno di febbraio è inferiore al giorno di gennaio).
DateTimeDiff("2016-02-14 23:59:59", "2016-01-15 00:00:00", "Months")
restituisce 0 (anche se manca solo un secondo per raggiungere il giorno richiesto).
DateTimeDiff('2017-02-28', '2016-02-29', 'Months')
restituisce 11 (anche se il 28 è l'ultimo giorno di febbraio nel 2017, è inferiore a 29).
DateTimeDiff('2017-02-28 00:59:59.28139502', '2017-02-28 00:59:59.12383125', 'msecs')
restituisce 157 (per millisecondi tra i valori data-ora).
Più informazioni
Per le differenze di mese e anno, un mese viene conteggiato solo quando il giorno di fine raggiunge il giorno di inizio, ignorando l'ora del giorno.
Per la precisione di giorno, ora, minuto e secondo, il risultato viene calcolato in modo preciso, quindi le parti frazionarie vengono troncate, non arrotondate. Quindi...
DateTimeDiff(‘2016-01-01 00:59:59’, ‘2016-01-01 00:00:00’, ‘Hours’)è zero.DateTimeDiff(‘2016-01-01 23:59:59’, ‘2016-01-01 00:00:00’, ‘Days’)è zero.
I nomi di precisione possono essere abbreviati con i primi tre caratteri (ad esempio "sec" e "min"); non esiste distinzione tra maiuscole e minuscole.
Presta attenzione quando si memorizzano le differenze di tempo in secondi. Un Int32 può includere solo una differenza di 68 anni in secondi o 4082 anni in minuti. È possibile utilizzare Double o Int64 per contenere intervalli tra tutte le date supportate.
DateTimeFirstOfMonth
DateTimeFirstOfMonth()
: restituisce il primo giorno del mese, a mezzanotte.
DateTimeFormat
DateTimeFormat(dt,f,l)
: converte i valori data-ora dal formato ISO a un formato specificato (f), in una lingua specifica (l) per l'uso da parte di un'altra applicazione. Output in un tipo di dati stringa. Se il formato specificato ha una precisione inferiore, l'output viene troncato.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
f
: il formato in cui convertire i dati, espresso in una stringa di formato.
l
: parametro lingua opzionale. Per impostazione predefinita, il parametro della lingua è impostato sulla lingua selezionata in Designer. Ad esempio, se Designer è impostato su Francese, per impostazione predefinita la funzione sarà . Per conoscere i valori accettati per la lingua, consulta l'argomento
Parametri lingua
.
Esempio
DateTimeFormat([DateTime_Out],"%d-%m-%Y")
restituisce 22-04-2008 per la data 22 aprile 2008 (formato ISO: 2008-04-22).
DateTimeFormat([DateTime_Out],"%A","Spanish")
restituisce "martes" per la data ISO 2020-07-14 (dove il 14 luglio cade di martedì).
DateTimeFormat('11:59:57.890994389','%H:%M:%S.%5')
restituisce "11:59:57.89099" (tronca a 5 cifre di precisione in base alle cifre specificate).
DateTimeFormat('11:59:57.99','%H:%M:%S,%3')
restituisce "11:59:57,990" (è possibile ottenere il separatore decimale delle impostazioni locali. In questo esempio viene utilizzata una virgola anziché una virgola decimale).
DateTimeHour
DateTimeHour(dt)
: restituisce la porzione dell'ora in un valore data-ora.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
Esempio
DateTimeHour("2017-03-24 11:43:23")
restituisce 11.
DateTimeHour("2017-03-24")
restituisce 0 poiché mezzanotte è l'ora presunta in cui non è specificata nessuna ora con una data.
DateTimeLastOfMonth
DateTimeLastOfMonth()
: restituisce l'ultimo giorno del mese corrente, con l'orologio impostato su un secondo prima della fine del giorno (23:59:59).
Designer utilizza la data e l'ora in cui la formula viene analizzata per la prima volta. In un processo batch, questa ora viene utilizzata con ogni nuovo set di dati. Ciò consente la coerenza se il processo richiede molto tempo.
DateTimeMinutes
DateTimeMinutes(dt)
: restituisce i minuti in un valore data-ora.
Parametri
dt
: dati Data e Ora, espressi come colonna selezionata o come valore Data e Ora specificato tra virgolette.
Esempio
DateTimeMinutes("2017-03-24 11:43:23")
restituisce 43.
DateTimeMonth
DateTimeMonth(dt)
: restituisce il valore numerico del mese in un valore data e ora.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
Esempio
DateTimeMonth("2017-03-24 11:43:23")
restituisce 3.
DateTimeMonth("11:43:23")
restituisce [Null] perché i dati in ingresso non sono validi.
DateTimeNow
DateTimeNow()
: restituisce la data e l'ora correnti del sistema in secondi.
DateTimeNowPrecise
DateTimeNowPrecise()
: restituisce la data e l'ora correnti del sistema con frazioni di secondo (fino a 18 cifre di precisione). Ricorda che se richiedi una precisione superiore a quella fornita dal sistema operativo, la funzione inserisce degli zeri per le cifre restanti.
Esempio
DateTimeNowPrecise(3)
restituisce '2022-10-14 11:59:57.991'.
DateTimeNowPrecise(12)
restituisce '2022-10-14 11:59:57.991238400000'.
DateTimeParse
DateTimeParse(string,f,l)
: converte una stringa data con il formato specificato (f) e in una lingua specifica (l) nel formato ISO standard (aaaa-mm-gg HH:MM:SS con precisione di data e ora opzionale se applicabile). Se il formato specificato ha una precisione inferiore, l'output viene troncato.
Parametri
string
: dati della stringa data-ora espressi come campo selezionato o come stringa data-ora tra virgolette. I dati in ingresso devono essere un tipo di dati stringa e possono avere qualsiasi formato data-ora, purché sia conforme al formato specificato per il parametro f.
f
: il formato dei dati della stringa della data in ingresso da convertire, espresso come stringa di formato tra virgolette.
l
: (facoltativo): la lingua dei dati della stringa della data in ingresso da convertire. Per impostazione predefinita, il parametro della lingua è impostato sulla lingua selezionata in Designer. Ad esempio, se Designer è impostato su Francese, per impostazione predefinita la funzione sarà . Per conoscere i valori accettati per la lingua, consulta l'argomento
Parametri lingua
.
Esempio
DateTimeParse("2016/28-03","%Y/%d-%m")
restituisce 2016-03-28.
DateTimeParse([DateTimeNow],"%A %d %B %Y", "Français")
restituisce 2020-07-14, dove la stringa della data in ingresso è "mardi 14 juillet 2020" (martedì 14 luglio 2020).
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S')
restituisce '2022-10-04 11:59:57'. La funzione esclude le cifre finali.
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S.%3')
restituisce '2022-10-04 11:59:57.990'. La funzione aggiunge zeri per corrispondere al formato %3.
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S,%3')
restituisce "2022-10-04 11:59:57.000" e un avviso che "," invece di "." era previsto.
DateTimeQuarter
DateTimeQuarter(dt, [Q1Start]
: restituisce il valore numerico per il trimestre dell'anno nel quale rientra un valore di data e ora (AAAA-MM-GG). Utilizza il parametro numerico opzionale per indicare il mese di inizio per il primo trimestre (Q1).
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
Q1Start
: parametro numerico opzionale per indicare il mese di inizio per Q1 (1-12).
Esempio
DateTimeQuarter("2023-01-03")
restituisce 1. Nessun errore perché il secondo parametro è opzionale.
DateTimeQuarter("2023-01-03", )
restituisce un errore. È previsto un secondo parametro.
DateTimeQuarter("2023-05-03", 1)
restituisce 2.
DateTimeQuarter("2023-05-03", 7)
restituisce 4. Il parametro opzionale indica che Q1 inizia a luglio.
DateTimeQuarter("2023-05-03 12:04:55", 7)
restituisce 4. Il parametro opzionale indica che Q1 inizia a luglio; l'indicatore di data e ora viene ignorato.
DateTimeQuarter("2023-01-03", 13)
restituisce null. Il secondo parametro deve essere un valore numerico compreso tra 1 e 12.
DateTimeQuarter("2023-01-03", 0)
restituisce null. Il secondo parametro deve essere un valore numerico compreso tra 1 e 12.
DateTimeQuarter("2023-01-03", -1)
restituisce null. Il secondo parametro deve essere un valore numerico compreso tra 1 e 12.
DateTimeQuarter("12:00:55")
restituisce null.
DateTimeSeconds
DateTimeSeconds(dt)
: restituisce la parte in secondi dell'ora in un valore di data e ora, inclusa la precisione al di sotto del secondo, se applicabile.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
Esempio
DateTimeSeconds('11:59:57.99')
restituisce 57.99.
DateTimeSeconds('11:59:57')
restituisce 57.
DateTimeStart
DateTimeStart()
: restituisce la data e l'ora di avvio del flusso di lavoro corrente.
DateTimeToday
DateTimeToday()
: restituisce la data odierna.
Comportamento previsto: tipo di dati DateTimeToday
Nonostante il nome,
DateTimeToday()
non restituisce un valore per l'ora, ma solo la data corrente. Puoi eseguire il wrapping della
DateTimeToday()
funzione nella
ToDateTime()
funzione per restituire un valore data-ora con l'ora impostata a mezzanotte del giorno corrente:
ToDateTime(DateTimeToday())
DateTimeToLocal
DateTimeToLocal(dt)
: converte un valore data-ora UTC nel fuso orario del sistema locale. La funzione DateTimeToLocal al momento non supporta la precisione di data e ora nel campo
dt
.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
Esempio
DateTimeToLocal('2014-08-01 20:01:25')
restituisce il fuso orario del sistema locale (fuso orario Mountain Time) come 2014-08-01 14:01:25.
DateTimeToUTC
DateTimeToUTC(dt)
: converte un parametro data-ora (nel fuso orario del sistema locale) in UTC. La funzione DateTimeToUTC attualmente non supporta la precisione di data e ora nel campo
dt
.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
Esempio
DateTimeToUTC(DateTimeNow())
restituisce Coordinated Universal Time in fase di esecuzione del flusso di lavoro: 2014-08-01 20:01:25 (dove l'ora del fuso orario Mountain Time locale era 2014-08-01 14:01:25)
DateTimeTrim
DateTimeTrim(dt,t)
: rimuove le porzioni indesiderate di un valore data-ora e restituisce il valore modificato.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
t
: tipo di taglio. Le opzioni includono:
firstofmonth : il taglio viene applicato all'inizio del mese (produce lo stesso effetto di mese).
lastofmonth : il taglio viene esteso fino a un secondo prima della fine dell'ultimo giorno del mese.
year : il taglio viene applicato a mezzanotte del 1° gennaio.
month : il taglio viene applicato a mezzanotte del primo giorno del mese.
day : il taglio viene applicato al giorno (ovvero mezzanotte). In questo modo un parametro data-ora viene convertito in un giorno con un'ora pari a zero (non una data).
hour : il taglio viene applicato all'ora.
minute : il taglio viene applicato al minuto.
secondi : taglio delle virgolette dei secondi e della seconda frazione utilizzando le parole chiave della sezione Parole chiave per unità data e ora .
Il taglio di un parametro data-ora non arrotonda il valore restituito. Ad esempio, l'ora 15:59:59 tagliata all'ora diventa 15:00:00, non 16:00:00.
Esempio
DateTimeTrim("2016-12-07 16:03:00","year")
restituisce 2016-01-01 00:00:00.
DateTimeTrim('2016-12-07 11:59:57.99','msec')
restituisce le 11:59:57.990.
DateTimeTrim('2016-12-07 11:59:57.99',4)
restituisce le 11:59:57.9900.
DateTimeTrim('2016-12-07 11:59:57.123456789','milliseconds')
restituisce le 11:59:57.123.
DateTimeYear
DateTimeYear(dt)
: restituisce il valore numerico dell'anno in un valore data e ora.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
Esempio
DateTimeYear("2017-03-24 11:43:23")
restituisce 2017.
ToDate
ToDate(x)
: converte una stringa, un numero o un valore data-ora in data.
Una stringa in ingresso deve essere formattata come YYYY-MM-DD. Ad esempio, 2020-10-31.
Un numero in ingresso deve essere formattato nel formato data di Excel, in cui il numero rappresenta il numero di giorni dal 01-01-1900. Ad esempio, 7000 che corrisponde a 03-01-1919.
Un valore data-ora in ingresso deve essere formattato come YYYY-MM-DD hh:mm:ss. Ad esempio, 2020-10-31 12:00:00.
Esempio
ToDate('2020-10-31')
restituisce la data 2020-10-31.
ToDate(7000)
restituisce la data 1919-03-01.
ToDate('2020-10-31 12:00:00')
restituisce la data 2020-10-31.
ToDateTime
ToDateTime(x)
: converte una stringa, un numero o una data in un valore data-ora. La funzione ToDateTime non supporta una precisione superiore a secondi. Limita i valori Excel alla rappresentazione in secondi (5 cifre, fino a 99999).
Una stringa in ingresso deve essere formattata come YYYY-MM-DD hh:mm:ss. Ad esempio, 2020-10-31 12:00:00.
Un numero in ingresso deve essere formattato nel formato data-ora di Excel, in cui il numero rappresenta il numero di giorni dal 01-01-1900. Ad esempio, 7000.354167 che corrisponde a 03-01-1919 alle 08:30 AM.
Esempio
ToDateTime('2020-10-31')
restituisce 2020-10-31 00:00:00 come valore data-ora.
ToDateTime(7000.354167)
restituisce 1919-03-01 08:30:00 come valore data-ora.
ToDateTime('2020-10-31 12:00:00')
restituisce 2020-10-31 12:00:00 come valore data-ora.