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.
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
.
Date Format
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)
: 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.
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)
: 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("2024-01-18", "2024-01-15", "days") returns 3.
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.
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()
: 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
.
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.
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).
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)
: 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.
Parameters
tz: (Optional) Provide a time zone for the returned time. If provided, the returned time uses that time zone. If omitted, the returned time uses your system time zone.
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.
Note that if you request precision beyond what your operating system provides, the function fills in the remainder with zeros, like in the second example below.
Parameters
digits: Specify the precision of the returned value, between 0 and 18 (inclusive).
tz: (Optional) Provide a time zone for the returned time. If provided, the returned time uses that time zone. If omitted, the returned time uses your system time zone.
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.
Time Zones
If the incoming format includes %z or %Z, Alteryx knows the input time zone. It converts the DateTime result value into the local or specified time zone. If the format or data does not have time zone information, Alteryx assumes the input is already in the local time zone, and does not apply any time shifts.
Review your data and take appropriate steps to ensure that your output is in the format you expect. For important time zone considerations, go to Time Zone and Daylight/Standard Time Changes.
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
.
tz: (Optional) The time zone to convert the data to if %z or %Z is in the format and the text has the name of a time zone or an offset in it. The examples will help to clarify this. If the time zone is omitted, the system time zone is used for conversion.
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.
DateTimeParse('Mar 10, 24 01:00:00 PST', '%b %d, %y %T %Z') returns '2024-03-10 04:00:00’ if the local time zone is Eastern.
DateTimeParse('Mar 12, 24 01:00:00 PST', '%b %d, %y %T %Z') returns ‘2024-03-12 05:00:00’ If the local time zone is Eastern because Eastern time has already changed to EDT (Eastern Daylight Time).
DateTimeParse('Mar 10, 24 01:00:00', '%b %d, %y %T %Z') returns ‘2024-03-10 01:00:00’ if the local time zone is Eastern. Even though the format asked for time zone information, none was present in the data. Without knowing the time zone for the input data, no conversion is done.
DateTimeParse('Mar 10, 24 01:00:00 PST', '%b %d, %y %T') returns ‘2024-03-11 01:00:00’. As in the above example, if the format does not ask to use time zone information, any data that might have time zone data is ignored.
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-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
.
Nota
The result doesn't have any indication about what its time zone is. You need to use DateTimeFormat or modify the result as a string to indicate the time zone if desired. If you use DateTimeFormat, the tz argument should be a name for the same tz used in the conversion. It could use a different style like EST, or Eastern Daylight Time, or America/New_York, or ‘-0400’. For important time zone considerations, go to Time Zone and Daylight/Standard Time Changes.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
tz: This is an optional time zone parameter to convert the date-time data to. If (tz) is not provided in the function call, the system time zone is used.
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.
DateTimeToLocal('2024-08-15 09:00:00.123') converts the UTC time to the system time, which could be America/New_York, returns ‘2024-08-15 05:00:00.123’, or it could be America/Denver, returning ‘2024-08-03:00:00.123’.
DateTimeToLocal('2024-08-15 09:00:00.123', 'EST') converts the UTC time to Eastern Daylight Time, even though the time specified is Standard Time. The daylight/standard specification is ignored when looking up the time zone for the conversion, so this returns ‘2024-08-15 05:00:00.123’.
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
.
Nota
The result doesn't have any indication that it is in UTC. You need to use DateTimeFormat or modify the result as a string to indicate the time zone if desired. If you use DateTimeFormat, the tz argument should be a name for the same time zone used in the conversion. It could use a different style like UTC, GMT, or Z, or ‘+0000’. For important time zone considerations, go to Time Zone and Daylight/Standard Time Changes.
Parametri
dt
: dati di data-ora espressi come colonna selezionata o come valore data-ora tra virgolette.
tz: This is an optional time zone parameter. If the tz is not given in the function call, the system time zone is used.
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)
DateTimeToUTC('2024-08-15 09:00:00.123') converts the time to UTC from the system time, which can be America/New_York, returning ‘2024-08-15 13:00:00.123’, or America/Denver, returning ‘2024-08-15:00:00.123’.
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.
Date-Time Function Reference
Refer to these specifiers, separators, keywords, and language parameters for use in date-time functions.
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
If you prefer to view an alphabetized list, you can do so below.
Identificatore | Output da DateTimeFormat | Input supportato con DateTimeParse |
|---|---|---|
Year | ||
| Last two digits of the year ("16"). | Up to 4 digits are read, stopping at a separator or the end of the string, and mapped to a range of the current year minus 66 to the current year plus 33. For example, in 2016, that's 1950 to 2049. Limitation with 6-Digit Dates Because up to 4 digits are read for the year, formats that are intended to have only 2 digits without a separator, such as a 6-digit date stamp (for example, %y%m%d for data resembling 170522 for May 22, 2017), are still read as 4 digits. To work around this limitation, you can...
|
| 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. |
Month | ||
| 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. |
| Abbreviated Month Name. Same as %b ("Sep"). | Any valid abbreviation of a month name ("Sep", "SEPT."). Returns an error only if the given text is not the name of a month. |
| Numero del mese, da 01 a 12. | Numero del mese a una o due cifre, da 1 o 01 a 12. |
Week | ||
| 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 |
Day of the Year/Month | ||
| 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) |
Day of the Week | ||
| 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. |
| 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 |
Hour, Minute, Second | ||
| 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, lo zero iniziale è lo spazio, da " 0" a "23". | 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. |
Miscellaneous | ||
| 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 è un nome di un mese. |
| 12 ore, lo zero iniziale è lo 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 | 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] |
| Offset dall'ora UTC ("-600"). | Non supportato |
| Nome completo del fuso orario ("Ora legale fuso occidentale"). | Non supportato |
Specifier | Output from DateTimeFormat | Supported Input with DateTimeParse |
|---|---|---|
| The number of digits of precision for sub-seconds. | Up to 18 digits of precision for sub-seconds. |
| Abbreviated Weekday Name ("Mon") | Any valid abbreviation of a day of the week ("mon", "Tues.", "Thur"). Returns an error only if the given text is not a day of the week. Note that Alteryx does not check that the specified day name is valid for a particular date. |
| Full Weekday Name ("Monday") | Day name or any valid abbreviation of a day of the week ("mon", "Tues.", "Thur"). Returns an error only if the given text is not a day of the week. Note that Alteryx does not check that the specified day name is valid for a particular date. |
| Abbreviated Month Name ("Sep") | Any valid abbreviation of a month name ("Sep", "SEPT."). Returns an error only if the given text is not the name of a month (in the specified language). |
| Full Month Name ("September") | Month name or any valid abbreviation of a month name ("Sep", "SEPT."). It returns an error only if the given text is not the name of a month (in the specified language). |
| The date and time for the computer’s locale. | Not Supported |
| The Century Number ("20") | Not Supported |
| Day of the Month ("01") | 1 or 2 digits, ignoring spaces ("1" or "01"). |
| Equivalent to %m/%d/%y | Not Supported |
| Day of the month, leading 0 replaced by a space (" 1"). | 1 or 2 digits, ignoring spaces ("1" or "01"). |
| Abbreviated Month Name. Same as %b ("Sep"). | Any valid abbreviation of a month name ("Sep", "SEPT."). Returns an error only if the given text is not a name of a month. |
| Hour in 24-hour clock, 00 to 23. | Up to 2 digits for hour, 0 to 23. Not compatible with %p or %P. |
| Hour in 12-hour clock, 01 to 12. | Up to 2 digits for hour, 1 to 12. Must follow with %p or %P. |
| The day of the year, from 001 to 365 (or 366 in leap years). | 3-digit day of the year, from 001 to 365 (or 366 in leap years). |
| 24 hours, leading zero is space, " 0" to "23". | Up to 2 digits for hour. |
| 12 hours, leading zero is space, " 1" to "12". | Not Supported |
| Minutes, 00 to 59 | Up to 2 digits for minutes. |
| Month number, 01 to 12. | 1 or 2-digit month number, 1 or 01 to 12. |
| "AM" or "PM" | Case blind ("aM" or "Pm"). Must follow %I (capital "eye", hour in 12-hour format). |
| "am" or "pm" | Case blind ("aM" or "Pm"). Must follow %I (capital "eye", hour in 12-hour format). |
| Seconds, 00 to 59 | Up to 2 digits for seconds. |
| Time in 24-hour notation. Equivalent to %H:%M:%S | Time in 24-hour notation. Equivalent to %H:%M:%S |
| Day of week as a decimal, 1 to 7, with Monday as 1. | Not Supported |
| This returns the week number, as 00–53, with the beginning of weeks as Sunday. | Not Supported |
| Day of week as a number, 0 to 6, with Sunday as 0. | Not Supported |
| This returns the week number, as 00–53, with the beginning of weeks as Monday. | Not Supported |
| The date for the computer’s locale. | Not Supported |
| The 12-hour clock time, including AM or PM ("11:51:02 AM"). | Hours:Minutes:Seconds [AM/PM] |
| Last two digits of the year ("16"). | Up to 4 digits are read, stopping at a separator or the end of the string, and mapped to a range of the current year minus 66 to the current year plus 33. For example, in 2016, that's 1950 to 2049. Limitation with 6-Digit Dates Because up to 4 digits are read for the year, formats that are intended to have only 2 digits without a separator, such as a 6-digit date stamp (for example, %y%m%d for data resembling 170522 for May 22, 2017), are still read as 4 digits. To work around this limitation, you can...
|
| All four digits of the year ("2016"). | Two or four digits are read. Two digits are mapped to a range from the current year minus 66 to the current year plus 33. For example, in 2024, that's 1958 to 2057. |
| Offset from UTC time ("-600"). | Supported for input. |
| Full timezone name ("Mountain Daylight Time"). | Supported for 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 - |
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.
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 |
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.
Time Zone Naming
There are many styles for naming time zones. Names can be long (Mountain Time), short (MT), specific (MDT, MST), or generic (MT). The Internet Assigned Names Authority (IANA) maintains a database of time zone information. Its style of name is Region/City (for example, America/Los Angeles, Europe/Paris).
Time information can also be marked with its offset relative to Coordinated Universal Time (UTC). For example, 11:31-0500 is a time zone that is 5 hours behind UTC (the same moment in UTC is 16:31). This time could be Central Daylight Time, Eastern Standard Time, or Peru Time. The IANA style is the canonical name for a time zone. Other names might be accepted depending on the user’s locale.
Alteryx uses a widely used library (ICU) to look up time zone information. If your workflow references a time zone that can't be found, the workflow reports an error.
Avvertimento
Please be aware that short names can be ambiguous. For example, IST can be Indian, Israel, or Ireland Standard Time. As such, be careful with your input data.
Alteryx recommends replacing short time zone names with long or IANA-style names to ensure that your data is handled properly. You can use the Find Replace tool to do this.
To find a time zone by name, if the Designer language is set to a language other than English (via User Settings > Language and Region), Alteryx first asks ICU to look up the time zone using that language. If it fails to find the time zone with that language, Alteryx then asks ICU to look up the time zone using English. It happens that in some regions, English abbreviations are used even when the local language has a long name for the zone.
Alteryx also attempts to look up the name in each supported language, starting with the Designer interface language (or the language specified in the function).
Suggerimento
You should be aware of the names used for time zones in your data, and possibly use the Find-Replace tool to ensure that you get appropriate names for time zones.
Time Zone and Daylight/Standard Time Changes
Time zones that have daylight and standard time changes encounter complications when trying to interpret times near the shift from daylight to standard and vice versa.
Shift to Daylight Time
There is an hour around the shift to daylight time (Summer) that is invalid. In the US when local standard time was about to reach March 10, 2024, 2:00:00 AM, clocks were turned forward 1 hour to March 10, 2024, 3:00:00 AM local daylight time instead.
As a result, there was no 2024-03-10 02:30:00 Eastern Time, for example. This time is invalid—there is no such time. However, Alteryx libraries don't detect this problem. If you convert DateTimeToUTC('2024-03-10 02:30:00', 'Eastern Time'), the code applies the offset for standard time (5 hours), and returns '2024-03-10 07:30:00' without any warning of the invalid input.
Shift to Standard Time
There is an hour at the shift to standard time that is ambiguous. In the US, when local daylight time is about to reach November 3, 2024, 2:00:00 AM, clocks are turned backward 1 hour to November 3, 2024, 1:00:00 AM local standard time instead.
2024-11-03 01:30:00 Eastern Time can be either Eastern Standard Time or Eastern Daylight Time. Since it is a very common error to specify EST for a time that is really in Daylight, or EDT for a time that is really Standard, the libraries generally ignore the season specification when looking up time zone information.
As a result, Alteryx can't convert the ambiguous hour from Eastern Time to UTC by using the specified season correctly. It applies the offset for standard time (5 hours) regardless of whether EST or EDT is specified as the time zone to use, that is...
DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Daylight Time')returns 2024-11-03 06:30:00.DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Standard Time')returns 2024-11-03 06:30:00.DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Time')returns 2024-11-03 06:30:00.
Notes and Limitations
Supporto data
Designer non è in grado di elaborare le date precedenti al 1° gennaio 1400.
Alteryx supports dates in years from 1400 to 9999. We assume all dates are in the Gregorian Calendar, which is the civil calendar used now in most of the world. All computations (adding and subtracting) ignore leap seconds.