Fonctions DateHeure
Une fonction DateHeure exécute une action ou un calcul sur une valeur de date et d’heure. Utilisez une fonction DateHeure pour ajouter ou soustraire des intervalles, trouver la date actuelle, trouver le premier ou le dernier jour du mois, extraire un composant d'une valeur de date/heure ou convertir une valeur vers un format différent.
Alteryx représente les dates et les heures au format ISO yyyy-mm-jj HH:MM:SS. Pour plus de précision (jusqu'à 18 chiffres de précision), ajoutez un point et des chiffres supplémentaires après la position des secondes. Par exemple,
yyyy-mm-dd HH:MM:SS.5
. Si une valeur DateHeure n’est pas dans ce format, elle sera lue comme une chaîne par alteryx. Pour convertir une colonne en vue de son utilisation et de sa manipulation au format DateHeure, utilisez la fonction DateTimeParse de l’éditeur d’expressions ou l’outil
DateHeure
.
Date Format
Certaines fonctions DateHeure vous obligent à définir le format de date. Les chaînes de format sont composées de spécificateurs et de séparateurs.
Fonctions DateHeure
Reportez-vous aux fonctions DateHeure ci-dessous.
DateTimeAdd
DateTimeAdd(dt,i,u)
: ajoute un intervalle spécifique à une valeur de date/heure.
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
i
: nombre entier positif ou négatif de temps à ajouter ou à soustraire.
u
: unité de temps, spécifiée entre guillemets à l'aide des mots-clés énumérés dans la section
Mots-clés pour les unités de temps
.
Exemple
DateTimeAdd(DateTimeToday(), -1, "days")
renvoie la date d'hier.
DateTimeAdd(DateTimeFirstOfMonth(), 1, "months")
renvoie le premier du mois suivant.
DateTimeAdd("2016-01-30", 1, "month")
renvoie 2016-02-29 (parce que février n’a pas 30 jours, mais cette année avait un 29 février).
DateTimeAdd("2016-03-30", -1, "month")
renvoie 2016-02-29 (parce que février n’a pas 30 jours, mais cette année avait un 29 février).
DateTimeAdd("2016-03-30 01:02:03.000000", 495, "microseconds")
renvoie 2016-03-30 01:02:03.000495.
En savoir plus
Toute fraction de la durée est tronquée. Par exemple, il n’est pas possible d’ajouter « 1,5 heure ». Ajoutez plutôt « 90 minutes ».
L’ajout d’une unité ne modifie pas la valeur des petites unités. Par exemple, l’ajout d’heures ne modifie pas la valeur des minutes ou des secondes. L'ajout de mois ne modifie pas le jour ou l'heure, sauf si le mois résultant ne comprend pas ce jour. Dans ce cas, le système affiche le dernier jour du mois en question.
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)
: renvoie la valeur numérique du jour du mois d'une valeur de date/heure.
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
Exemple
DateTimeDay("2017-03-24 11:43:23")
renvoie 24.
DateTimeDiff
DateTimeDiff(dt1,dt2,u)
: soustrait le deuxième argument du premier et renvoie la différence sous forme de nombre entier. La durée est retournée sous la forme d'un nombre, et non d'une chaîne, dans les unités de temps spécifiées.
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
u
: unité de temps, spécifiée entre guillemets à l'aide des mots-clés énumérés dans la section
Mots-clés pour les unités de temps
.
Exemple
DateTimeDiff("2024-01-18", "2024-01-15", "days")
returns 3.
DateTimeDiff("2016-02-15 00:00:00", "2016-01-15 00:00:01", "Months")
renvoie 1 (car le début et la fin sont le même jour du mois).
DateTimeDiff("2012-02-29","2011-03-01","years")
renvoie 0 (même si 2012-02-29 est 365 jours après 2011-03-01, le 29 février vient avant le 1er mars, par conséquent, « une année » n'est pas encore achevée).
DateTimeDiff("2016-02-14", "2016-01-15", "Months")
renvoie 0 (parce que les jours de février sont inférieurs aux jours de janvier.)
DateTimeDiff("2016-02-14 23:59:59", "2016-01-15 00:00:00", "Months")
renvoie 0 (même s’il ne manque qu'une seconde pour arriver au jour souhaité)
DateTimeDiff('2017-02-28', '2016-02-29', 'Months')
renvoie 11 (même si le 28 février est le dernier jour du mois de février 2017, 28 est moins que 29).
DateTimeDiff('2017-02-28 00:59:59.28139502', '2017-02-28 00:59:59.12383125', 'msecs')
renvoie 157 (pour les millisecondes entre les valeurs date/heure).
En savoir plus
Pour les différences de mois et d’année, un mois est uniquement pris en considération quand le jour de fin atteint le jour de début, en ignorant l’heure du jour.
Pour la précision des paramètres Jour, Heure, Minute et Seconde, le résultat est calculé avec exactitude, puis les fractions sont tronquées, non arrondies. Par conséquent…
DateTimeDiff(‘2016-01-01 00:59:59’, ‘2016-01-01 00:00:00’, ‘Hours’)
est zéro.DateTimeDiff(‘2016-01-01 23:59:59’, ‘2016-01-01 00:00:00’, ‘Days’)
est zéro.
Les noms de précisions peuvent être abrégés pour ne contenir que leurs trois premiers caractères (« sec » et « min » par exemple) et ne sont pas sensibles à la casse.
Faites attention lorsque vous enregistrez les différences temporelles en secondes. Int32 ne peut enregistrer qu'une différence de 68 ans en secondes ou de 4082 ans en minutes. Vous pouvez utiliser des données de type Double ou Int64 pour conserver les intervalles entre toutes les dates prises en charge.
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()
: renvoie le premier jour du mois, à minuit.
DateTimeFormat
DateTimeFormat(dt,f,l)
: convertit des données de date/heure du format ISO en un autre format spécifié (f), dans une langue spécifiée (l), pour une utilisation par une autre application. La sortie générée est un type de données Chaîne. Si le format spécifié est moins précis, la sortie est tronquée.
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
f
: le format dans lequel les données sont converties, exprimé par une chaîne de format.
l
: paramètre de langue facultatif. Par défaut, la langue est définie sur celle sélectionnée dans Designer. Par exemple, si Designer est défini sur Français, la fonction indique
DateTimeParse(dt,f,"Français")
par défaut. Consultez
Paramètres de langue
pour connaître les valeurs de langue acceptées.
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.
Exemple
DateTimeFormat([DateTime_Out],"%d-%m-%Y")
renvoie 22-04-2008 pour la date du 22 avril 2008 (format ISO : 2008-04-22).
DateTimeFormat([DateTime_Out],"%A","Spanish")
renvoie « martes » pour la date ISO 2020-07-14 (où le 14 juillet est un mardi).
DateTimeFormat('11:59:57.890994389','%H:%M:%S.%5')
renvoie « 11:59:57.89099 » (troncation à 5 chiffres de précision en fonction des chiffres spécifiés).
DateTimeFormat('11:59:57.99','%H:%M:%S,%3')
Renvoie '11:59:57,990' (vous pouvez obtenir le séparateur décimal de vos paramètres locaux. Dans cet exemple, nous utilisons une virgule au lieu d'un point décimal).
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)
: renvoie la partie horaire d'une valeur de date/heure.
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
Exemple
DateTimeHour("2017-03-24 11:43:23")
renvoie 11.
DateTimeHour("2017-03-24")
renvoie 0, car minuit est l’heure prise en compte quand aucune heure n’est indiquée avec une date.
DateTimeLastOfMonth
DateTimeLastOfMonth()
: renvoie le dernier jour du mois en cours, avec l'horloge définie à une seconde avant la fin du jour (23:59:59).
Designer utilise la date et l'heure auxquelles la formule est analysée pour la première fois. Dans le cadre d’un traitement par lots, cette même heure est utilisée pour chaque nouvel ensemble de données. Cela permet de garantir la cohérence des résultats en cas d'un long processus.
DateTimeMinutes
DateTimeMinutes(dt)
: renvoie la partie minutes d'une valeur de date/heure.
Paramètres
dt
: données de date/heure, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur de date/heure spécifiée entre guillemets.
Exemple
DateTimeMinutes("2017-03-24 11:43:23")
renvoie 43.
DateTimeMonth
DateTimeMonth(dt)
: renvoie la valeur numérique du mois d'une valeur de date/heure.
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
Exemple
DateTimeMonth("2017-03-24 11:43:23")
renvoie 3.
DateTimeMonth("11:43:23")
renvoie [Null], parce que les données entrantes ne sont pas valides.
DateTimeNow
DateTimeNow()
: renvoie la date et l'heure actuelles du système en secondes.
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()
: renvoie la date et l'heure actuelles du système avec des fractions de seconde (jusqu'à 18 chiffres de précision). Remarque : si vous demandez une précision au-delà des capacités de votre système d'exploitation, cette fonction remplit le reste avec des zéros, comme dans le deuxième exemple ci-dessous.
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.
Exemple
DateTimeNowPrecise(3)
renvoie « 2022-10-14 11:59:57.991 ».
DateTimeNowPrecise(12)
renvoie « 2022-10-14 11:59:57.991238400000 ».
DateTimeParse
DateTimeParse(string,f,l)
: convertit une chaîne de date (string) dans un format (f) et une langue (l) spécifiés au format ISO standard (yyyy-mm-dd HH:MM:SS avec une précision date/heure facultative le cas échéant). Si le format spécifié est moins précis, la sortie est tronquée.
Paramètres
string
: données de chaîne date/heure, exprimées par un champ sélectionné ou une chaîne de date/heure entre guillemets. Les données entrantes doivent être de type Chaîne et peuvent se présenter dans tout format de date/heure, tant que ce format est conforme à celui que vous définissez pour le paramètre f.
f
: format des données de chaîne de date entrantes que vous convertissez, exprimées dans une chaîne de format entre guillemets.
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
: (facultatif) langue des données de chaîne de date entrantes que vous convertissez. Par défaut, la langue est définie sur celle sélectionnée dans Designer. Par exemple, si Designer est défini sur Français, la fonction indique
DateTimeParse(string,f,"Français")
par défaut. Consultez la section
Paramètres de langue
pour connaître les valeurs de langue prises en charge.
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.
Exemple
DateTimeParse("2016/28-03","%Y/%d-%m")
renvoie 2016-03-28.
DateTimeParse([DateTimeNow],"%A %d %B %Y", "Français")
renvoie 2020-07-14, où la chaîne de date entrante est « mardi 14 juillet 2020 » (en français).
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S')
renvoie « 2022-10-04 11:59:57 ». Cette fonction supprime les chiffres de fin.
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S.%3')
renvoie « 2022-10-04 11:59:57.990 ». Cette fonction ajoute des zéros pour correspondre au format %3.
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S,%3')
renvoie « 2022-10-04 11:59:57.000 » ainsi qu'un avertissement indiquant que « , » était attendu au lieu de « . ».
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]
: renvoie la valeur numérique du trimestre de l'année qui contient une valeur date/heure (YYYY-MM-DD). Utilisez le paramètre numérique facultatif pour indiquer le mois de début du premier trimestre (Q1).
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
Q1Start
: paramètre numérique facultatif pour indiquer le mois de début du premier trimestre (1 à 12).
Exemple
DateTimeQuarter("2023-01-03")
renvoie 1. Aucune erreur ne se produit, car le deuxième paramètre est facultatif.
DateTimeQuarter("2023-05-03", 1)
renvoie 2.
DateTimeQuarter("2023-05-03", 7)
renvoie 4. Le paramètre facultatif indique que le premier trimestre commence en juillet.
DateTimeQuarter("2023-05-03 12:04:55", 7)
renvoie 4. Le paramètre facultatif indique que le premier trimestre commence en juillet, et l'horodatage est ignoré.
DateTimeQuarter("2023-01-03", 13)
Renvoie Null. Le deuxième paramètre doit être une valeur numérique comprise entre 1 et 12.
DateTimeQuarter("2023-01-03", 0)
Renvoie Null. Le deuxième paramètre doit être une valeur numérique comprise entre 1 et 12.
DateTimeQuarter("2023-01-03", -1)
Renvoie Null. Le deuxième paramètre doit être une valeur numérique comprise entre 1 et 12.
DateTimeQuarter("12:00:55")
Renvoie Null.
DateTimeSeconds
DateTimeSeconds(dt)
: renvoie la partie en secondes de l'heure dans une valeur de date/heure, et toute valeur inférieure à la seconde, le cas échéant.
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
Exemple
DateTimeSeconds('11:59:57.99')
renvoie 57.99.
DateTimeSeconds('11:59:57')
renvoie 57.
DateTimeStart
DateTimeStart()
: renvoie la date et l'heure à laquelle le workflow en cours a commencé à s'exécuter.
DateTimeToday
DateTimeToday()
: renvoie la date d'aujourd'hui.
Comportement attendu : type de données DateTimeToday
Malgré son nom,
DateTimeToday()
ne renvoie pas de valeur horaire. Elle renvoie uniquement une date avec la date actuelle. Vous pouvez envelopper la fonction
DateTimeToday()
dans la fonction
ToDateTime()
pour renvoyer une valeur de date/heure avec l'heure fixée à minuit du jour en cours :
ToDateTime(DateTimeToday())
DateTimeToLocal
DateTimeToLocal(dt)
: convertit les données de date/heure UTC vers le fuseau horaire local du système. La fonction DateTimeToLocal ne prend pas en charge la précision date et heure dans le champ
dt
pour le moment.
Note
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.
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
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.
Exemple
DateTimeToLocal('2014-08-01 20:01:25')
renvoie le fuseau horaire du système local (heure des Rocheuses) au format 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)
: convertit les données de date/heure (du fuseau horaire du système local) en UTC. La fonction DateTimeToUTC ne prend pas en charge la précision date et heure dans le champ
dt
pour le moment.
Note
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.
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
tz
: This is an optional time zone parameter. If the tz is not given in the function call, the system time zone is used.
Exemple
DateTimeToUTC(DateTimeNow())
renvoie le temps universel coordonné à l'exécution du workflow : 2014-08-01 20:01:25 (où l'heure locale des Rocheuses était 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)
: supprime les portions non souhaitées d'une valeur de date/heure et renvoie la valeur de date/heure modifiée.
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
t
: type d’ajustement. Plusieurs options sont possibles :
firstofmonth : ajustement au début du mois (ce qui fait la même chose que « month »).
lastofmonth : ajustement jusqu'à une seconde avant la fin du dernier jour du mois.
year : ajustement à minuit le 1er janvier.
month : ajustement à minuit le premier jour du mois.
day : ajustement au jour (à minuit). Cette option permet de convertir une valeur de date/heure en jour, en remettant l'heure à zéro (pas une date).
hour : ajustement à l'heure.
minute : ajustement à la minute.
seconds : ajustement aux secondes et aux fractions de seconde de la section Mots-clés des unités de date/heure .
L'ajustement d'une valeur de date/heure n'arrondit pas la valeur renvoyée. Par exemple, l’heure 15:59:59 ajustée à l’heure devient 15:00:00 et non 16:00:00.
Exemple
DateTimeTrim("2016-12-07 16:03:00","year")
renvoie 2016-01-01 00:00:00.
DateTimeTrim('2016-12-07 11:59:57.99','msec')
renvoie 11:59:57.990.
DateTimeTrim('2016-12-07 11:59:57.99',4)
renvoie 11:59:57.9900.
DateTimeTrim('2016-12-07 11:59:57.123456789','milliseconds')
renvoie 11:59:57.123.
DateTimeYear
DateTimeYear(dt)
: renvoie la valeur numérique de l'année d'une valeur de date/heure.
Paramètres
dt
: données de date/heure, exprimées par une colonne sélectionnée ou une valeur de date/heure spécifiée entre guillemets.
Exemple
DateTimeYear("2017-03-24 11:43:23")
renvoie 2017.
ToDate
ToDate(x)
: convertit une chaîne, un nombre ou une valeur de date/heure en une date.
Une chaîne entrante doit être au format YYYY-MM-DD. Par exemple, 2020-10-31.
Un nombre entrant doit être au format de date d'Excel, où le nombre représente le nombre de jours écoulés depuis le 01-01-1900. Par exemple, 7000 correspond au 03-01-1919.
Une valeur de date/heure entrante doit être au format YYYY-MM-DD hh:mm:ss. Par exemple, 2020-10-31 12:00:00.
Exemple
ToDate('2020-10-31')
renvoie 2020-10-31 comme date.
ToDate(7000)
renvoie 1919-03-01 comme date.
ToDate('2020-10-31 12:00:00')
renvoie 2020-10-31 comme date.
ToDateTime
ToDateTime(x)
: convertit une chaîne, un nombre ou une date en une valeur de date/heure. La fonction ToDateTime ne supporte pas une précision supérieure à quelques secondes. Elle limite les valeurs Excel à la représentation des secondes (5 chiffres, jusqu'à 99 999).
Une chaîne entrante doit être au format YYYY-MM-DD hh:mm:ss. Par exemple, 2020-10-31 12:00:00.
Un nombre entrant doit être au format de date/heure d'Excel, où le nombre représente le nombre de jours écoulés depuis le 01-01-1900. Par exemple, 7000.354167 correspond au 03-01-1919 à 8:30 AM.
Exemple
ToDateTime('2020-10-31')
renvoie 2020-10-31 00:00:00 comme valeur de date/heure.
ToDateTime(7000.354167)
renvoie 1919-03-01 08:30:00 comme valeur de date/heure.
ToDateTime('2020-10-31 12:00:00')
renvoie 2020-10-31 12:00:00 comme valeur de date/heure.
Date-Time Function Reference
Refer to these specifiers, separators, keywords, and language parameters for use in date-time functions.
Spécificateurs
Les spécificateurs commencent toujours par un symbole de pourcentage (%), suivi d'un nombre ou d'une lettre sensible à la casse. Les données doivent inclure au moins une année à deux chiffres.
Astuce
If you prefer to view an alphabetized list, you can do so below.
Spécificateur | Sortie du format DateHeure | Entrée prise en charge avec 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...
|
| Les quatre chiffres de l'année (« 2016 »). | 2 ou 4 chiffres sont lus. 2 chiffres sont associés à une plage allant de l'année actuelle moins 66 à l'année actuelle plus 33. Par exemple, en 2016, la plage va de 1950 à 2049. |
Month | ||
| Nom abrégé du mois (« Sep ») | Toute abréviation valide d'un nom de mois (« Sep », « SEPT. »). Renvoie une erreur uniquement si le texte donné n'est pas le nom d'un mois. |
| Nom complet du mois (« Septembre ») | Nom de mois ou toute abréviation valide d'un nom de mois (« Sep », « SEPT. »). Renvoie une erreur uniquement si le texte donné n'est pas le nom d'un mois. |
| 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. |
| Numéro du mois, de 01 à 12. | Numéro représentant le mois à 1 ou 2 chiffres, de 1 ou 01 à 12. |
Week | ||
| Renvoie le numéro de la semaine, de 00 à 53 (le dimanche étant considéré comme premier jour de la semaine). | Non pris en charge |
| Renvoie le numéro de la semaine, de 00 à 53 (le lundi étant considéré comme premier jour de la semaine). | Non pris en charge |
Day of the Year/Month | ||
| Jour du mois (« 01 ») | 1 ou 2 chiffres, sans espaces (« 1 » ou « 01 »). |
| Jour du mois, le 0 initial étant remplacé par un espace (« 1 »). | 1 ou 2 chiffres, sans espaces (« 1 » ou « 01 »). |
| Jour de l’année, de 001 à 365 (ou 366 en années bissextiles) | Jour de l’année à 3 chiffres, de 001 à 365 (ou 366 en années bissextiles) |
Day of the Week | ||
| Nom abrégé du jour de la semaine (« Lun ») | Toute abréviation valide d'un jour de la semaine (« lun », « mar », « jeu »). Renvoie une erreur uniquement si le texte donné n'est pas un jour de la semaine. Notez qu’Alteryx ne vérifie pas si le nom du jour correspond bien à la date indiquée. |
| Nom complet du jour de la semaine (« Lundi ») | Nom du jour ou toute abréviation valide d'un jour de la semaine (« lun », « mar », « jeu »). Renvoie une erreur uniquement si le texte donné n'est pas un jour de la semaine. Notez qu’Alteryx ne vérifie pas si le nom du jour correspond bien à la date indiquée. |
| Jour de la semaine sous forme de décimale, de 1 à 7, le lundi étant représenté par 1. | Non pris en charge |
| Jour de la semaine sous forme de nombre, de 0 à 6, le dimanche étant représenté par 0. | Non pris en charge |
Hour, Minute, Second | ||
| Heure au format 24 heures, de 00 à 23. | Jusqu'à 2 chiffres pour l'heure, de 0 à 23. Non compatible avec %p ou %P. |
| Heure au format 12 heures, de 01 à 12. | Jusqu'à 2 chiffres pour l'heure, de 1 à 12. Doit être suivi de %p ou %P. |
| 24 heures, le zéro au début est une espace, de « 0 » à « 23 ». | Jusqu'à 2 chiffres pour l'heure. |
| Minutes, de 00 à 59 | Jusqu'à 2 chiffres pour les minutes. |
| Secondes, de 00 à 59 | Jusqu'à 2 chiffres pour les secondes. |
Miscellaneous | ||
| Nombre de chiffres de précision pour les sous-secondes. | Jusqu'à 18 chiffres de précision pour les sous-secondes. |
| Date et heure des paramètres régionaux de l'ordinateur. | Non pris en charge |
| Nombre représentant le siècle (« 20 ») | Non pris en charge |
| Équivalent de %m/%d/%y | Non pris en charge |
| Identique à %b ("Sep") | Toute abréviation valide d'un nom de mois (« Sep », « SEPT. »). Renvoie une erreur uniquement si le texte donné n'est pas le nom d'un mois. |
| 12 heures, le zéro au début est une espace, de « 1 » à « 12 ». | Non pris en charge |
| « AM » ou « PM » | Insensible à la casse (« aM » ou « Pm »). Doit suivre %I (« I » majuscule, heure au format 12 heures). |
| « am » ou « pm » | Insensible à la casse (« aM » ou « Pm »). Doit suivre %I (« I » majuscule, heure au format 12 heures). |
| Heure en notation 24 heures. Équivalent de %H:%M:%S | Non pris en charge |
| Date des paramètres régionaux de l'ordinateur. | Non pris en charge |
| Heure de l'horloge au format 12 heures, incluant AM ou PM (« 11:51:02 AM »). | Heures:Minutes:Secondes [AM / PM] |
| Décalage par rapport à l'heure UTC (« -600 »). | Non pris en charge |
| Nom complet du fuseau horaire (« Mountain Daylight Time »). | Non pris en charge |
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. |
Séparateurs
Les séparateurs sont insérés entre les spécificateurs date/heure pour former une chaîne de format.
Séparateur | Sortie du format DateHeure | Entrée prise en charge avec DateTimeParse* |
---|---|---|
| / | / ou - |
| - | / ou - |
espace | Une espace | Toute séquence de caractères d'espace vide. |
| Une nouvelle ligne | Non pris en charge |
| Une tabulation | Non pris en charge |
autre | Autres caractères, tels que virgule, point et deux-points. | Autres caractères, tels que virgule, point et deux-points. |
*DateTimeParse accepte les barres obliques (/) et les traits d'union (-) d'une manière interchangeable. Toutefois, les virgules, deux-points et tous les autres séparateurs doivent correspondre exactement aux données entrantes.
Mots-clés pour les unités de date/heure
Ces mots-clés sont compatibles avec les fonctions DateTimeAdd, DateTimeDiff et DateTimeTrim. Les mots-clés ne sont pas sensibles à la casse. Les mots-clés pris en charge pour chaque unité sont séparés par des virgules.
Dans certains cas, les abréviations jusqu'au mot-clé complet sont prises en charge. Ceux-ci sont spécifiés avec
upto
dans la liste ci-dessous et vont de l'abréviation acceptable la plus courte au mot-clé complet. Par exemple, pour les secondes, nous acceptons
sec
et
seconds
, ainsi que tout ce qui se trouve entre les deux, par exemple
seco
. Notez que les mots-clés sont en anglais et que la traduction dans d'autres langues n'est pas prise en charge.
Vous pouvez également utiliser des valeurs numériques comme mots-clés pour les sous-secondes, notamment des unités qui ne sont pas spécifiquement mentionnées dans la liste ci-dessous. Par exemple, vous pouvez utiliser le mot-clé « 10 » pour indiquer 10 chiffres de précision.
yea upto years
mon upto months
day, days
hou upto hours
min upto minutes
sec upto seconds
ds, dsec, dsecs, deciseconds, 1
cs, csec, csecs, centiseconds, 2
ms, msec, msecs, milliseconds, 3
us, usec, usecs, microseconds, 6
ns, nsec, nsecs, nanoseconds, 9
ps, psec, psecs, picoseconds, 12
fs, fsec, fsecs, femtoseconds, 15
as, asec, asecs, attoseconds, 18
Pour obtenir des exemples de taille de champ DateHeure avec différentes unités de précision, reportez-vous au tableau suivant :
Nom | Abréviation | Taille DateHeure | Exemple |
---|---|---|---|
Secondes |
| (par défaut) 19* | 2023-02-24 01:23:45 |
Décisecondes (1) |
| 21 (19 + 1 + 1) | 2023-02-24 01:23:45.1 |
Centisecondes (2) |
| 22 (19 + 1 + 2) | 2023-02-24 01:23:45.12 |
Millisecondes (3) |
| 23 (19 + 1 + 3) | 2023-02-24 01:23:45.123 |
Microsecondes (6) |
| 26 (19 + 1 + 6) | 2023-02-24 01:23:45.123456 |
Nanosecondes (9) |
| 29 (19 + 1 + 9) | 2023-02-24 01:23:45.123456789 |
Picosecondes (12) |
| 32 (19 + 1 + 12) | 2023-02-24 01:23:45.123456789012 |
Femtosecondes (15) |
| 35 (19 + 1 + 15) | 2023-02-24 01:23:45.123456789012345 |
Attosecondes (18) |
| 38 (19 + 1 + 18) | 2023-02-24 01:23:45.123456789012345678 |
Paramètres de langue
Les éléments suivants sont les valeurs compatibles du paramètre « l » (langue) pris en charge par les fonctions DateTimeFormat et DateTimeParse .
Nom de la langue en anglais | Nom de la langue dans la langue | Code de langue |
---|---|---|
English | English | en |
Italian | Italiano | it |
French | Français | fr |
German | Deutsch | de |
Japanese | 日本語 | ja |
Spanish | Español | es |
Portuguese | Português | pt |
Chinese | 简体中文 | zh |
Outre les valeurs ci-dessus, les valeurs d'au moins 2 caractères commençant par l'une des valeurs ci-dessus sont également acceptées. Par exemple, eng, engl, engli, etc. pour l'anglais ou esp, espa, sp, spa, span, etc. pour l'espagnol.
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.
Avertissement
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).
Astuce
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
Prise en charge de la date
Designer ne peut pas traiter les dates antérieures au 1er janvier 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.