Funzioni di data e ora
Una funzione di data e ora esegue un'azione o un calcolo su un valore di data e ora. Puoi usare una funzione di 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 di data e ora o convertire un valore di questo tipo in un formato diverso.
Alteryx utilizza il formato 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.fff. Quando 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.
Formato della data
Alcune funzioni Data e ora richiedono l'impostazione del formato della data. Le stringhe di formato sono costituite da identificatori e separatori.
Funzioni Data e ora
Fai riferimento alle funzioni DateTime riportate di seguito.
DateTimeAdd
DateTimeAdd(dt,i,u): Adds a specific interval to a date-time value.
Parameters
dt: Date-time data.
i: Positive or negative integer of time to add or subtract.
u: Date-time unit, specified between quotes using keywords listed in the Keywords for Date-Time Units section.
Example
DateTimeAdd(DateTimeToday(), -1, "days") returns yesterday’s date.
DateTimeAdd(DateTimeFirstOfMonth(), 1, "months") returns the first of the next month.
DateTimeAdd("2016-01-30", 1, "month") returns 2016-02-29 (because February does not have a 30th, but its last day that year is the 29th).
DateTimeAdd("2016-03-30", -1, "month") returns 2016-02-29 (because February does not have a 30th, but its last day that year is the 29th).
DateTimeAdd("2016-03-30 01:02:03.000000", 495, "microseconds") returns 2016-03-30 01:02:03.000495.
Read More
Any fraction in the duration is truncated. For example, you cannot add "1.5 hours". Instead, add "90 minutes".
Adding a unit does not change the value of smaller units. For example, adding hours does not change the value of minutes or seconds. Adding months does not change the day or time unless the resulting month does not have such a day. In that case, it goes to the last day of that month.
This function performs calculations as if the time zone does not have time changes related to Daylight and Standard time. This might produce unexpected results if your calculation includes dates and times when the time changes from Daylight to Standard or vice versa. If the precision of the actual time that passes is critical, you should first convert your data to UTC.
DateTimeDay
DateTimeDay(dt): Returns the numeric value for the day of the month in a date-time value.
Parameters
dt: Date-time data.
Example
DateTimeDay("2017-03-24 11:43:23") returns 24.
DateTimeDiff
DateTimeDiff(dt1,dt2,u): Subtracts the second argument from the first (dt1 – dt 2) and returns the difference as an integer. The duration is returned as a number, not a string, in the specified time units.
Parameters
dt: Date-time data.
u: Date-time unit, specified between quotes using keywords from the Keywords for Date-Time Units section.
Example
DateTimeDiff("2024-01-18", "2024-01-15", "days") returns 3.
DateTimeDiff("2016-02-15 00:00:00", "2016-01-15 00:00:01", "Months") returns 1 (because the start and end are the same day of the month).
DateTimeDiff("2012-02-29","2011-03-01","years") returns 0 (even though 2012-02-29 is 365 days after 2011-03-01, February 29 is before March 1st, so "one year" has not yet been completed).
DateTimeDiff("2016-02-14", "2016-01-15", "Months") returns 0 (because the day in February is less than the day in January).
DateTimeDiff("2016-02-14 23:59:59", "2016-01-15 00:00:00", "Months") returns 0 (even though it is only one second short of reaching the required day).
DateTimeDiff('2017-02-28', '2016-02-29', 'Months') returns 11 (even though the 28th is the last day of February in 2017, the 28 is less than 29).
DateTimeDiff('2017-02-28 00:59:59.28139502', '2017-02-28 00:59:59.12383125', 'msecs') returns 157 (for milliseconds between date-time values).
Read More
For Month and Year differences, a month is only counted when the end day reaches the start day, ignoring the time of day.
For precision of Day, Hour, Minute, and Second, the result is calculated precisely, then fractional parts are truncated, not rounded. Therefore...
DateTimeDiff(‘2016-01-01 00:59:59’, ‘2016-01-01 00:00:00’, ‘Hours’)is zero.DateTimeDiff(‘2016-01-01 23:59:59’, ‘2016-01-01 00:00:00’, ‘Days’)is zero.
Precision names can be shortened to their first three characters (like 'sec' and 'min'), case is insensitive.
Be careful when storing time differences in seconds. An Int32 can only hold a difference of 68 years in seconds or 4082 years in minutes. You can use a Double or an Int64 to hold intervals between all supported dates.
This function performs calculations as if the time zone does not have time changes related to Daylight and Standard time. This might produce unexpected results if your calculation includes dates and times when the time changes from Daylight to Standard or vice versa. If the precision of the actual time that passes is critical, you should first convert your data to UTC.
DateTimeFirstOfMonth
DateTimeFirstOfMonth(): Returns the first day of the month, at midnight.
DateTimeFormat
DateTimeFormat(dt,f,[l],[tz]): Converts date-time data from ISO format to another specified format (f), in a specified language (l), using the time zone name (tz) for use by another application. Output to String data type. If the specified format carries less precision than the incoming data, the output is truncated and not rounded. For example, if you pass in a time to microseconds (.012789) and the format specifies the time to milliseconds, the result is truncated to .012 rather than rounded to .013. The optional time zone parameter lets you control the style of the text that is added to the string (for example, 'EDT').
Parameters
dt: Date-time data.
f: The format to which to convert the data, expressed in a format string. Refer to the Specifiers section below.
l: This is an optional language parameter. It defaults to your selected Designer language. For example, if Designer is set to French, the function reads DateTimeParse(dt,f,"Français") by default. Note that if you omit this parameter, the function uses English regardless of your Designer interface language. Go to Language Parameters for a list of accepted language values.
tz: This is an optional time zone parameter. Note that the data is not converted. This is simply to guide the style of the text added to the string.
The time zone identifier determines what offset to show if you use the offset format instruction (%z) or to get a name for the time zone to show if you use the time zone name format instruction (%Z).
The time zone name preserves the style of the argument: short (like EST), long (like Eastern Standard Time), generic (like ET), or specific (like EST/EDT).
The name is modified to match the correct season for the data. For example, if the tz is provided as EST for 2024-08-15, it is corrected to EDT. Similarly, for 2024-01-15, if the tz is provided as EDT, it is corrected to EST. For both of these examples, if the tz is provided as a generic ET it is not changed to show whether it is Daylight or Standard time.
If the tz is not provided in the function call, the system time zone is used (or the time zone specified in the Workflow Configuration Runtime settings).
Example
DateTimeFormat('2008-04-22',"%d-%m-%Y") returns 22-04-2008 for the date April 22, 2008 (ISO format: 2008-04-22).
DateTimeFormat([DateTime_Out],"%A","Spanish") returns "martes" for the ISO date 2020-07-14 (where July 14th is a Tuesday).
DateTimeFormat('11:59:57.890994389','%H:%M:%S.%5') returns '11:59:57.89099' (Truncates to 5 digits of precision based on digits specified).
DateTimeFormat('11:59:57.99','%H:%M:%S,%3') returns '11:59:57,990' (You can get your locale’s decimal separator. This example uses a comma instead of a decimal point).
DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %Z', '', 'ET') returns 'Mar 10, 24 01:00:00 ET'. The style of the time zone argument is short and generic, so that is used in the result.
DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %Z', '', 'EDT') returns 'Mar 10, 24 01:00:00 EST'. The style of the time zone argument is short and specific. It's incorrect for the time of the data. The result gets the specific time zone offset corrected.
DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %Z', '', 'Eastern Time') returns 'Mar 10, 24 01:00:00 Eastern Time’. The style is kept, and no shift needs to be corrected.
DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %Z', '', 'Eastern Daylight Time') returns 'Mar 10, 24 01:00:00 Eastern Standard Time’. The time zone shift is corrected.
DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %z', '', 'ET') returns 'Mar 10, 24 01:00:00 -0400’.
DateTimeHour
DateTimeHour(dt): Returns the hour portion of the time in a date-time value.
Parameters
dt: Date-time data.
Example
DateTimeHour("2017-03-24 11:43:23") returns 11.
DateTimeHour("2017-03-24") returns 0, as midnight is the assumed hour when no time is specified with a date.
DateTimeLastOfMonth
DateTimeLastOfMonth(): Returns the last day of the current month, with the clock set to one second before the end of the day (23:59:59).
This function gets the current time and adjusts it each time you call it. It does not depend on the workflow's start time.
DateTimeMinutes
DateTimeMinutes(dt): Returns the minutes portion of the time in a date-time value.
Parameters
dt: DateTime data.
Example
DateTimeMinutes("2017-03-24 11:43:23") returns 43.
DateTimeMonth
DateTimeMonth(dt): Returns the numeric value for the month in a date-time value.
Parameters
dt: Date-time data.
Example
DateTimeMonth("2017-03-24 11:43:23") returns 3.
DateTimeMonth("11:43:23") returns [Null], because the incoming data is not valid.
DateTimeNow
DateTimeNow([tz]): restituisce la data e l'ora correnti, inclusi i secondi. Quando pecifichi il parametro del fuso orario (tz) opzionale, l'orario restituito si riferisce a quel fuso orario. Quando specifichi un fuso orario nelle impostazioni di runtime della configurazione del flusso di lavoro, l'ora restituita viene basata su tale fuso orario. In caso contrario, viene utilizzato il fuso orario di sistema.
Parametri
tz: (opzionale) consente di fornire un fuso orario per l'ora restituita. Se fornito, l'ora restituita è basata su tale fuso orario. Se omesso, viene utilizzato il fuso orario di sistema o quello specificato nelle impostazioni di runtime della configurazione del flusso di lavoro.
DateTimeNowPrecise
DateTimeNowPrecise(digits,[tz]): restituisce la data e l'ora correnti del sistema con frazioni di secondo (fino a 18 cifre di precisione). Quando pecifichi il parametro del fuso orario (tz) opzionale, l'orario restituito si riferisce a quel fuso orario. Quando non viene specificato alcun fuso orario, l'ora restituita è basata sul fuso orario di sistema o su quello specificato nelle impostazioni di runtime della configurazione del flusso di lavoro.
Ricorda che se richiedi una precisione superiore a quella fornita dal sistema operativo, la funzione inserisce degli zeri per le cifre restanti.
Parametri
cifre: specifica la precisione del valore restituito, tra 0 e 18 (inclusi).
tz: (opzionale) consente di fornire un fuso orario per l'ora restituita. Se fornito, l'ora restituita utilizza questo fuso orario. Se omesso, l'ora restituita utilizza il fuso orario del sistema in uso.
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],[tzName]): converte una stringa data con il formato specificato (f) e in una lingua specificata (l), con il fuso orario specificato (tzName) nel formato (AAAA-MM-GG HH:MM:SS) con la precisione di data-ora opzionale, se applicabile). Quando il formato specificato ha una precisione inferiore, l'output viene troncato.
Parametri
stringa: dati stringa data-ora. 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.
Fusi orari
Quando il formato in entrata include %z o %Z e il testo di input contiene informazioni sul fuso orario, Alteryx riconosce il fuso orario di input. Converte pertanto il valore di data e ora risultante in base al fuso orario fornito, a quello specificato nelle impostazioni di runtime della configurazione del flusso di lavoro, o al fuso orario locale (fuso orario di sistema). Quando il formato o i dati non contengono informazioni sul fuso orario, Alteryx presuppone che l'input sia già nel fuso orario locale e non applica quindi alcun spostamento di orario.
Esamina i tuoi dati e adotta le misure appropriate per assicurarti che l'output sia nel formato previsto. Per importanti considerazioni sul fuso orario, consulta la sezione Fuso orario e cambio dell'ora legale/ora standard.
l: (facoltativo): la lingua dei dati della stringa della data in ingresso da convertire. Per impostazione predefinita, quando si modificano le formule, il parametro della lingua è impostato sulla lingua selezionata in Designer. Se omesso o vuoto, viene utilizzato "Inglese". Ad esempio, se Designer fosse impostato su Francese, per impostazione predefinita la funzione sarebbe DateTimeParse(string,f,"Français"). Per conoscere i valori accettati per la lingua, consulta l'argomento Parametri lingua.
tz: (facoltativo) il fuso orario in cui convertire i dati se %z o %Z sono presenti nel formato e se il testo contiene il nome di un fuso orario o di un offset. Gli esempi contribuiranno a chiarire questo aspetto. Se il fuso orario viene omesso, viene utilizzato il fuso orario specificato nelle impostazioni di runtime della configurazione del flusso di lavoro (o il fuso orario di sistema).
Esempio
DateTimeParse("2016/28-03","%Y/%d-%m") restituisce 2016-03-28.
DateTimeParse('mardi 14 juillet 2020', '%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 [Null] e l'avviso che era previsto "," invece di ".".
DateTimeParse('Mar 10, 24 01:00:00 PST', '%b %d, %y %T %Z') restituisce "2024-03-10 04:00:00" se il fuso orario locale è Eastern.
DateTimeParse('Mar 12, 24 01:00:00 PST', '%b %d, %y %T %Z') restituisce "2024-03-12 05:00:00" se il fuso orario locale è il fuso orientale perché l'orario orientale è già cambiato in EDT (Eastern Daylight Time).
DateTimeParse('Mar 10, 24 01:00:00', '%b %d, %y %T %Z') restituisce "2024-03-10 01:00:00" se il fuso orario locale è Eastern. Anche se il formato richiedeva informazioni sul fuso orario, queste non erano presenti nei dati. Senza conoscere il fuso orario dei dati di input, non viene eseguita alcuna conversione.
DateTimeParse('Mar 10, 24 01:00:00 PST', '%b %d, %y %T') restituisce "2024-03-11 01:00:00". Come nell'esempio precedente, qualora il formato non richiedesse di utilizzare le informazioni sul fuso orario, tutti i dati che potrebbero contenere dati sul fuso orario verranno ignorati.
DateTimeQuarter
DateTimeQuarter(dt,[Q1Start]): restituisce il valore numerico per il trimestre dell'anno nel quale rientra un valore data-ora (AAAA-MM-GG). Utilizza il parametro numerico opzionale per indicare il mese di inizio per il primo trimestre (Q1).
Parametri
dt: dati data-ora.
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-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 data-ora, inclusa la precisione al di sotto del secondo, se applicabile.
Parametri
dt: dati data-ora.
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, utilizzando il fuso orario di sistema o quello specificato nelle impostazioni di runtime della configurazione del flusso di lavoro.
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,[tz]): converte un valore di data/ora in formato UTC basandosi sull'argomento facoltativo tz, altrimenti utilizza il fuso orario del sistema locale o quello specificato nelle impostazioni di runtime della configurazione del flusso di lavoro. La funzione DateTimeToLocal ora supporta la precisione di data-ora nel campo dt.
Nota
Il risultato non contiene alcuna indicazione su quale sia il suo fuso orario. Devi utilizzare DateTimeFormat o modificare il risultato come stringa per indicare il fuso orario, se richiesto. Se utilizzi DateTimeFormat, l'argomento tz deve essere un nome dello stesso tz utilizzato nella conversione. Potrebbe utilizzare uno stile diverso come EST, o Eastern Daylight Time, America/New_York oppure "-0400". Per importanti considerazioni sul fuso orario, consulta la sezione Fuso orario e cambio dell'ora legale/ora standard.
Parametri
dt: dati data-ora.
tz: parametro del fuso orario opzionale in base al quale convertire i dati data-ora. Quando (tz) non viene fornito nella chiamata della funzione, viene utilizzato il fuso orario del sistema.
Esempio
DateTimeToLocal('2014-08-01 20:01:25') converte il fuso orario del sistema locale (Mountain Time) in 2014-08-01 14:01:25.
DateTimeToLocal('2024-08-15 09:00:00.123') Converte l'ora UTC nell'orario del sistema che potrebbe essere America/New_York, restituendo "2024-08-15 05:00:00.123" oppure potrebbe essere America/Denver, restituendo "2024-08-03:00:00.123".
DateTimeToLocal('2024-08-15 09:00:00.123', 'EST') Converte l'ora UTC in ora legale orientale, anche se l'ora specificata è l'ora standard. La specifica dell'ora legale/standard viene ignorata quando si cerca il fuso orario per la conversione e quindi si ottiene "2024-08-15 05:00:00.123".
DateTimeToUTC
DateTimeToUTC(dt,[tz]): converte un valore data-ora (nel fuso orario del sistema locale o nel fuso orario fornito) in UTC. Si presume che l'input del valore data-ora si riferisca al fuso orario specificato o nel fuso orario del sistema in cui è in esecuzione il flusso di lavoro. La funzione DateTimeToUTC ora supporta la precisione di data-ora nel campo dt.
Quando il parametro tz viene omesso, la funzione utilizza il fuso orario specificato nelle impostazioni di runtime della configurazione del flusso di lavoro o nel fuso orario del sistema locale.
Nota
Il risultato non contiene alcuna indicazione che si tratti dell'ora UTC. Devi utilizzare DateTimeFormat o modificare il risultato come stringa per indicare il fuso orario, se richiesto. Quando utilizzi DateTimeFormat, l'argomento tz deve essere un nome dello stesso fuso orario utilizzato nella conversione. Può utilizzare uno stile diverso, come UTC, GMT o Z oppure "+0000". Per importanti considerazioni sul fuso orario, consulta la sezione Fuso orario e cambio dell'ora legale/ora standard.
Parametri
dt: dati data-ora.
tz: un parametro del fuso orario opzionale. Quando nella chiamata alla funzione non viene fornito il parametro tz, viene utilizzato il fuso orario specificato nelle impostazioni di runtime della configurazione del flusso di lavoro oppure il fuso orario di sistema.
Esempio
DateTimeToUTC(DateTimeNow()) restituisce Coordinated Universal Time in fase di esecuzione del flusso di lavoro: 2014-08-01 20:01:25 (dove l'ora locale del fuso orario Mountain time era 2014-08-01 14:01:25)
DateTimeToUTC('2024-08-15 09:00:00.123') converte l'ora in UTC dall'orario del sistema, che può essere America/New_York, restituendo "2024-08-15 13:00:00.123" o America/Denver, restituendo "2024-08-15:00:00.123".
DateTimeTrim
DateTimeTrim(dt,t): rimuove le porzioni indesiderate di un valore data-ora e restituisce il valore data-ora modificato.
Parametri
dt: dati data-ora.
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 a 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-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 2016-12-07 11:59:57.990.
DateTimeTrim('2016-12-07 11:59:57.99',4) restituisce 2016-12-07 11:59:57.9900.
DateTimeTrim('2016-12-07 11:59:57.123456789','milliseconds') restituisce 11:59:57.123.
DateTimeWeekNum
DateTimeWeek(dt, [StartOfWeek]): restituisce il valore numerico (1-54) della settimana dell'anno in cui cade una data, utilizzando la settimana che contiene il 1° gennaio come prima settimana (analogamente alla funzione WeekNum di Excel). Utilizza il parametro numerico opzionale (StartOfWeek) per indicare il giorno iniziale della settimana. Ad esempio, 1 = domenica, 2 = lunedì e così via.
Parametri
dt: dati data-ora.
StartOfWeek: parametro facoltativo che indica il primo giorno della settimana. Ad esempio, 1 = domenica, 2 = lunedì e così via. Il parametro StartOfWeek tronca i valori numerici, convertendo 6,8 in 6, 1,3 in 1 e così via. L'impostazione predefinita è 1, che corrisponde alla domenica.
Esempio
DateTimeWeekNum("2023-01-03") restituisce 1 (nessun errore, poiché il secondo parametro è facoltativo).
DateTimeWeekNum("2023-01-03", ) restituisce un errore, poiché è previsto il parametro facoltativo StartOfWeek.
DateTimeWeekNum("2023-01-03", 0) restituisce null.
DateTimeWeekNum("2023-01-23", 4) restituisce 4 (la settimana inizia di mercoledì).
DateTimeWeekNum("2023-01-08", 6.8) restituisce 2 (il valore viene troncato da 6,8 a 6, determinando una settimana che inizia da venerdì).
DateTimeWorkDays
DateTimeWorkDays(dt1, dt2, [StartofWeek]): restituisce il numero di giorni lavorativi interi tra due date, presupponendo una settimana lavorativa di 5 giorni che inizia di lunedì. Utilizza il parametro opzionale (StartofWeek) per indicare il giorno in cui inizia la settimana lavorativa, dove 1 = domenica, 2 = lunedì,..., 7 = sabato.
Questa funzione conta i giorni compresi fra la data di inizio dt1 e la data di fine dt2. Di conseguenza, quando la data dt1 è precedente a dt2, il risultato è un valore positivo. Se dt1 è invece una data successiva a dt2, il risultato è un valore negativo.
Nota
Se una festività cade in un giorno feriale, la funzione lo considera un giorno lavorativo.
Parametri
dt: dati data-ora.
StartOfWeek: parametro facoltativo che indica il giorno iniziale della settimana lavorativa. Ad esempio, 1 = domenica, 2 = lunedì e così via. Il parametro StartOfWeek tronca i decimali, convertendo 6,8 in 6, 1,3 in 1 e così via.
Esempio
DateTimeWorkDays("2024-01-02", "2024-01-04", 1) restituisce 3. La settimana lavorativa inizia da lunedì, che è il giorno predefinito.
DateTimeWorkDays("2024-01-02", "2024-01-04", 4) restituisce 2. La settimana lavorativa inizia da mercoledì. La settimana lavorativa va da mercoledì a domenica, mentre lunedì e martedì vengono considerati giorni del "fine settimana".
DateTimeWorkDays("2024-01-02", "2024-01-04", 3.8) restituisce 3. La settimana lavorativa inizia da martedì (la funzione tronca i decimali). La settimana lavorativa va da martedì a sabato, mentre domenica e lunedì vengono considerati giorni del "fine settimana".
DateTimeWorkDays("2024-01-04", "2024-01-02", 1) restituisce -3. Tieni presente che dt1 è una data successiva a dt2.
DateTimeYear
DateTimeYear(dt): restituisce il valore numerico dell'anno in un valore data-ora.
Parametri
dt: dati data-ora.
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.
Il numero fornito viene interpretato come il numero dei giorni trascorsi a partire dal giorno 1899-12-30. Ad esempio, 7000 corrisponde al giorno 03-01-1919. Come puoi notare,
ToDate(1.5)restituisce 1899-12-31 (i decimali vengono troncati).Un valore data-ora in ingresso deve essere formattato come AAAA-MM-GG 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.
Il numero fornito rappresenta il numero dei giorni trascorsi a partire dal giorno 1899-12-30. Ad esempio, 7000.354167 corrisponde alle ore 8.30 del giorno 03-01-1919. I decimali vengono interpretati come orario, con una precisione nell'ordine dei secondi.
ToDateTime(1.5)restituisce 1899-12-31 00:00:00.
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 di data e ora.
ToDateTime('2020-10-31 12:00:00') restituisce 2020-10-31 12:00:00 come valore di data e ora.
Riferimento funzione data-ora
Fare riferimento a questi identificatori, separatori, parole chiave e parametri della lingua per l'uso nelle funzioni data-ora.
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.
Suggerimento
Se preferisci visualizzare un elenco alfabetico, puoi farlo qui in basso.
Identificatore | Output da DateTimeFormat | Input supportato con DateTimeParse |
|---|---|---|
Anno | ||
| 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 2025, gli anni a due cifre vengono interpretati come gli anni compresi tra il 1959 e il 2058. 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 compreso tra l'anno corrente meno 66 e l'anno corrente più 33. Ad esempio, per il 2024, risulta tra 1958 e 2057. |
Mese | ||
| Nome abbreviato del mese ("set") | Qualsiasi abbreviazione valida del nome di un mese ("Set", "SET."). Restituisce un errore solo se il testo specificato non è il 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 è il nome di un mese (nella lingua specificata). |
| Nome abbreviato del mese Uguale a %b ("set") | Qualsiasi abbreviazione valida del nome di un mese ("Set", "SET."). Restituisce un errore solo se il testo specificato non è il nome di un mese. |
| Numero del mese, da 01 a 12. | Numero del mese a una o due cifre, da 1 o 01 a 12. |
Settimana | ||
| Restituisce il numero della settimana, come 00 – 53, con l'inizio delle settimane come domenica. | Non supportato |
| Restituisce il numero della settimana, come 00 – 53, con l'inizio delle settimane come lunedì. | Non supportato |
Giorno dell'anno/mese | ||
| Giorno del mese ("01") | Una o due cifre, ignorando gli spazi ("1" o "01"). |
| Giorno del mese, 0 iniziale sostituito da uno spazio (" 1"). | Una o due cifre, ignorando gli spazi ("1" o "01"). |
| 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) |
Giorno della settimana | ||
| 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. Tieni presente che Alteryx non verifica la corrispondenza tra il nome del giorno specificato e la data specificata. |
| 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. Tieni presente che Alteryx non verifica la corrispondenza tra il nome del giorno specificato e la data specificata. |
| Giorno della settimana come decimale, da 1 a 7, con lunedì come 1. | Non supportato |
| Giorno della settimana come numero, da 0 a 6, con domenica come 0. | Non supportato |
Ora, minuto, secondo | ||
| 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. |
| 24 ore, da "0" a "23", lo zero iniziale viene sostituito da uno spazio. | Fino a due cifre per l'ora. |
| Minuti, da 00 a 59 minuti | Fino a due cifre per i minuti. |
| Secondi, da 00 a 59 | Fino a due cifre per i secondi. |
Varie | ||
| Il numero di cifre di precisione per i sottosecondi. | Fino a 18 cifre di precisione per sottosecondi. |
| La data e l'ora delle impostazioni locali del computer. | Non supportato |
| Numero del secolo ("20") | Non supportato |
| Equivalente a %m/%d/%y | Non supportato |
| Uguale a %b ("set") | Qualsiasi abbreviazione valida del nome di un mese ("Set", "SET."). Restituisce un errore solo se il testo specificato non è il nome di un mese. |
| 12 ore, lo zero iniziale è uno spazio, da " 1" a "12". | Non supportato |
| "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). |
| Tempo in notazione a 24 ore. Equivalente a %H:%M:%S | Tempo in notazione a 24 ore. Equivalente a %H:%M:%S |
| 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"). | Ore:Minuti:Secondi [AM/PM] |
| Scostamento dall'ora UTC ("-600"). | Supportato per l'input. |
| Nome completo del fuso orario ("Ora legale fuso occidentale"). | Supportato per l'input. |
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. Tieni presente che Alteryx non verifica la corrispondenza tra il nome del giorno specificato e la data specificata. |
| 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. Tieni presente che Alteryx non verifica la corrispondenza tra il nome del giorno specificato e la data specificata. |
| Nome abbreviato del mese ("set") | Qualsiasi abbreviazione valida del nome di un mese ("Set", "SET."). Restituisce un errore solo se il testo specificato non è il 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 è il nome di un mese (nella lingua specificata). |
| 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"). |
| Nome abbreviato del mese 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, da "0" a "23", lo zero iniziale viene sostituito da uno spazio. | Fino a due cifre per l'ora. |
| 12 ore, lo zero iniziale è uno 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 | Tempo in notazione a 24 ore. Equivalente a %H:%M:%S |
| 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 della settimana 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"). | Ore:Minuti:Secondi [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 va dal 1950 al 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 compreso tra l'anno corrente meno 66 e l'anno corrente più 33. Ad esempio, per il 2024, risulta tra 1958 e 2057. |
| Offset dall'ora UTC ("-600"). | Supportato per l'input. |
| Nome completo del fuso orario ("Ora legale fuso occidentale"). | Supportato per l'input. |
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 - |
spazio | 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.
Parole chiave per unità data-ora
Queste parole chiave sono compatibili con le funzioni DateTimeAdd, DateTimeDiff e DateTimeTrim. Le parole chiave non fanno distinzione 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 |
Parametri lingua
Si tratta dei valori compatibili per il parametro "l" (lingua) supportati dalle 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.
Denominazione del fuso orario
Sono disponibili molti stili per la denominazione dei fusi orari. I nomi possono essere lunghi (Mountain Time), brevi (MT), specifici (MDT, MST) o generici (MT). L'Internet Assigned Names Authority (IANA) gestisce un database delle informazioni sui fusi orari. Lo stile seguito per i nomi è Region/City (ad esempio America/Los Angeles, Europe/Paris).
Le informazioni sull'ora possono essere contrassegnate anche con l'offset relativo al fuso orario Coordinated Universal Time (UTC). Ad esempio, 11:31-0500 è un fuso orario che è 5 ore indietro rispetto al fuso orario UTC (nello stesso momento del fuso UTC sono le 16:31). Questo orario potrebbe essere Central Daylight Time, Eastern Standard Time o Peru Time. Lo stile IANA è il nome canonico di un fuso orario. Altri nomi potrebbero essere accettati a seconda delle impostazioni locali dell'utente.
Alteryx utilizza (ICU), una libreria ampiamente utilizzata per cercare informazioni sul fuso orario. Se il flusso di lavoro fa riferimento a un fuso orario che non riesce a trovare, il flusso di lavoro genera un errore.
Avvertimento
Tieni presente che i nomi brevi possono essere ambigui. Ad esempio, IST può essere Indian Standard Time, Israel Standard Time e Ireland Standard Time. Pertanto, fai attenzione ai dati di input.
Alteryx consiglia di sostituire i nomi brevi dei fusi orari con i nomi lunghi o nello stile IANA, in modo da garantire che i dati vengano gestiti correttamente. A tale scopo, puoi utilizzare lo strumento Trova Sostituisci.
Per trovare un fuso orario in base al nome, qualora la lingua in Designer fosse impostata su una lingua diversa dall'inglese (tramite Impostazioni utente > Lingua e regione), Alteryx interroga la libreria ICU per cercare il fuso tramite questa lingua. Quando non riesce a trovare il fuso orario con quella lingua, Alteryx interroga la libreria ICU per cercare il fuso orario utilizzando l'inglese. In alcune regioni, vengono utilizzate le abbreviazioni in inglese anche quando la lingua locale prevede un nome lungo per il fuso orario. Se Alteryx non trova il nome in inglese, lo cerca in tutte le lingue supportate, a partire dalla lingua dell'interfaccia di Designer o da quella specificata nella funzione. Ricorda che i nomi dei fusi orari ICU nelle lingue diverse dall'inglese sono limitati.
Suggerimento
Devi essere a conoscenza dei nomi utilizzati per i fusi orari nei dati, ed eventualmente utilizzare lo strumento Trova e sostituisci, per assicurarti di ottenere nomi appropriati per i fusi orari.
Fuso orario e cambio dell'ora legale/standard
I fusi orari che prevedono il cambio dell'ora legale e dell'ora standard presentano complicazioni quando si cerca di interpretare gli orari in prossimità del passaggio dall'ora legale e l'ora standard e viceversa.
Passaggio all'ora legale
C'è un'ora in prossimità del passaggio all'ora legale (estate) che non è valida. Negli Stati Uniti, quando l'ora standard locale sta per raggiungere il 10 marzo 2024, 2:00:00 AM, gli orologi vengono spostati in avanti di 1 ora al 10 marzo 2024, 3:00:00 ora legale locale.
Di conseguenza, 2024-03-10 02:30:00 Eastern time è un valore inesistente, ad esempio. Questo orario non è valido, in quanto inesistente. Tuttavia, le librerie Alteryx non rilevano il problema. Se convertissi DateTimeToUTC('2024-03-10 02:30:00', 'Eastern Time'), il codice applicherà l'offset per l'ora standard (5 ore) e restituirà "2024-03-10 07:30:00", senza alcun avviso dell'input non valido.
Passaggio all'ora standard
C'è un orario in prossimità del cambio dell'ora standard che è ambiguo. Negli Stati Uniti, quando l'ora legale locale sta per raggiungere il 3 novembre 2024, 2:00:00, gli orologi vengono spostati indietro di 1 ora al 3 novembre 2024, 1:00:00 ora standard locale.
2024-11-03 01:30:00 Eastern Time può riferirsi sia a Eastern Standard Time che a Eastern Daylight Time. Poiché è un errore molto comune specificare EST per un orario che cade realmente nell'ora legale nel fuso orario Eastern Daylight Time, o EDT per un orario che cade realmente nell'ora standard, le librerie generalmente ignorano la specifica della stagione quando cercano informazioni sul fuso orario.
Di conseguenza, Alteryx non può convertire l'ora ambigua da Eastern Time a UTC utilizzando correttamente la stagione specificata. Il sistema applica l'offset per l'ora standard (5 ore) indipendentemente dal fatto che sia specificato EST o EDT come fuso orario da utilizzare, ovvero...
DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Daylight Time')restituisce 2024-11-03 06:30:00.DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Standard Time')restituisce 2024-11-03 06:30:00.DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Time')restituisce 2024-11-03 06:30:00.
Note e limitazioni
Supporto data
Alteryx Designer non è in grado di elaborare date precedenti al 1° gennaio 1400.
Alteryx supporta date comprese tra il 1400 e il 9999. Supponiamo che tutte le date siano espresse nel Calendario gregoriano, il calendario civile che al momento è utilizzato in gran parte del mondo. Tutti i calcoli (somma e sottrazione) ignorano i secondi intercalari.