Funciones de fecha y hora
Las funciones de fecha y hora te permiten realizar una acción o cálculo en un valor de fecha y hora. Utiliza una función de fecha y hora para agregar o restar intervalos, buscar la fecha actual, buscar el primer o último día del mes, extraer un componente de un valor de fecha y hora o convertir un valor a un formato diferente.
Alteryx utiliza el formato ISO yyyy-mm-dd HH:MM:SS para representar fechas y horas. Para exactitud adicional (hasta 18 dígitos de precisión), agrega un punto y dígitos adicionales después de la posición de segundos. Por ejemplo,
yyyy-mm-dd HH:MM:SS.5
. Si un valor de fecha y hora no está en este formato, Alteryx lo lee como una cadena. Para convertir una columna para uso y manipulación en el formato de fecha y hora, utiliza la función DateTimeParse en el editor de expresiones o en la
herramienta Fecha y hora
.
Date Format
Algunas funciones de fecha y hora requieren que establezcas el formato de la fecha. Las cadenas de formato constan de especificadores y separadores.
Funciones de fecha y hora
Consulta las funciones DateTime a continuación.
DateTimeAdd
DateTimeAdd(dt,i,u)
: agrega un intervalo específico a un valor de fecha y hora.
Parámetros
dt
: datos de fecha y hora, expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
i
: entero positivo o negativo de tiempo para sumar o restar.
u
: unidad de fecha y hora, especificada entre comillas mediante las palabras clave que aparecen en a sección
Palabras clave para unidades de fecha y hora
.
Ejemplo
DateTimeAdd(DateTimeToday(), -1, "days")
devuelve la fecha de ayer.
DateTimeAdd(DateTimeFirstOfMonth(), 1, "months")
devuelve el primero del mes siguiente.
DateTimeAdd("2016-01-30", 1, "month")
devuelve 2016-02-29 (porque febrero no tiene un 30, pero su último día ese año es el 29).
DateTimeAdd("2016-03-30", -1, "month")
devuelve 2016-02-29 (porque febrero no tiene un 30, pero su último día ese año es el 29).
DateTimeAdd("2016-03-30 01:02:03.000000", 495, "microseconds")
devuelve 2016-03-30 01:02:03.000495.
Lee más
Cualquier fracción de la duración es trucada. Por ejemplo, no puedes sumar "1.5 horas". En vez, suma "90 minutos".
Sumar una unidad no cambia el valor de unidades más pequeñas. Por ejemplo, agregar horas no cambia el valor de minutos o segundos. Sumar meses no cambia el día o la hora, a menos que el mes resultante no tenga tal día. En ese caso, va al último día de ese mes.
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)
: devuelve el valor numérico correspondiente al día del mes en un valor fecha y hora.
Parámetros
dt
: datos de fecha y hora, expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
Ejemplo
DateTimeDay("2017-03-24 11:43:23")
devuelve 24.
DateTimeDiff
DateTimeDiff(dt1,dt2,u)
: resta el segundo argumento del primero y lo devuelve como diferencia en número entero. La duración se devuelve como un número, no una cadena, en las unidades de tiempo especificadas.
Parámetros
dt
: datos de fecha y hora expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
u
: unidad de fecha y hora, especificada entre comillas mediante palabras clave de la sección
Palabras clave para unidades de fecha y hora
.
Ejemplo
DateTimeDiff("2024-01-18", "2024-01-15", "days")
returns 3.
DateTimeDiff("2016-02-15 00:00:00", "2016-01-15 00:00:01", "Months")
devuelve 1 (porque el inicio y el final son el mismo día del mes).
DateTimeDiff("2012-02-29","2011-03-01","years")
devuelve 0 (aunque 2012-02-29 es 365 días después de 2011-03-01, el 29 de febrero es antes del 1 de marzo, por lo que “un año” aún no se ha completado).
DateTimeDiff("2016-02-14", "2016-01-15", "Months")
devuelve 0 (porque el día de febrero es menor que el día de enero).
DateTimeDiff("2016-02-14 23:59:59", "2016-01-15 00:00:00", "Months")
devuelve 0 (aunque es solo un segundo menos del día requerido).
DateTimeDiff('2017-02-28', '2016-02-29', 'Months')
devuelve 11 (aunque el 28 es el último día de febrero de 2017, el 28 es menor que el 29).
DateTimeDiff('2017-02-28 00:59:59.28139502', '2017-02-28 00:59:59.12383125', 'msecs')
devuelve 157 (para milisegundos entre valores de fecha y hora).
Lee más
Para las diferencias de mes y de año, un mes se cuenta solamente cuando el último día alcanza el primer día, ignorando la hora del día.
Para la exactitud del día, hora, minuto y segundo, el resultado se calcula con precisión y las partes fraccionarias se truncan, no se redondean. Por lo tanto…
DateTimeDiff(‘2016-01-01 00:59:59’, ‘2016-01-01 00:00:00’, ‘Hours’)
es cero.DateTimeDiff(‘2016-01-01 23:59:59’, ‘2016-01-01 00:00:00’, ‘Days’)
es cero.
Los nombres de precisiones se pueden acortar a sus tres primeros caracteres en inglés (como “sec” y “min”); no distingue entre mayúsculas y minúsculas.
Ten cuidado al almacenar las diferencias de tiempo en segundos. Un Int32 solo puede tener una diferencia de 68 años en segundos o 4082 años en minutos. Puedes utilizar tipos Double o Int64 para mantener intervalos entre todas las fechas admitidas.
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()
: devuelve el primer día del mes, a medianoche.
DateTimeFormat
DateTimeFormat(dt,f,l)
: convierte datos de fecha y hora del formato ISO a otro formato especificado (f) y en un idioma especificado (l) para su uso por otra aplicación. Las salidas generadas son de tipo de dato de cadena. Si el formato especificado tiene menos precisión, la salida se trunca.
Parámetros
dt
: datos de fecha y hora, expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
f
: formato al cual convertir los datos, expresados en una cadena de formato.
l
: parámetro de idioma opcional. El parámetro de idioma se establece de forma predeterminada en el idioma de Alteryx Designer seleccionado. Por ejemplo, si Designer se establece en francés, la función lee
DateTimeParse(dt,f,"Français")
de forma predeterminada. Consulta
Parámetros de idioma
para conocer los valores de idioma aceptados.
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.
Ejemplo
DateTimeFormat([DateTime_Out],"%d-%m-%Y")
devuelve 22-04-2008 para la fecha 22 de abril de 2008 (formato ISO: 2008-04-22).
DateTimeFormat([DateTime_Out],"%A","Spanish")
devuelve “martes” para la fecha ISO 2020-07-14 (en la que el 14 de julio es un martes).
DateTimeFormat('11:59:57.890994389','%H:%M:%S.%5')
devuelve '11:59:57,89099' (se trunca a 5 dígitos de precisión según los dígitos especificados).
DateTimeFormat('11:59:57.99','%H:%M:%S,%3')
devuelve '11:59:57.990' (puedes obtener el separador decimal de tu configuración regional. Este ejemplo utiliza una coma en lugar de un punto decimal).
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)
: devuelve la porción de horas de la hora en un valor de fecha y hora.
Parámetros
dt
: datos de fecha y hora expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
Ejemplo
DateTimeHour("2017-03-24 11:43:23")
devuelve 11.
DateTimeHour("2017-03-24")
devuelve 0, ya que la medianoche es la hora supuesta cuando no se especifica una hora con la fecha.
DateTimeLastOfMonth
DateTimeLastOfMonth()
: devuelve el último día del mes actual, con el reloj establecido en un segundo antes del final del día (23:59:59).
Designer usa la fecha y hora en que se analiza la fórmula por primera vez. En un proceso por lotes, la misma fecha y hora se utilizan con cada nuevo conjunto de datos. Esto permite consistencia si el proceso tarda mucho tiempo.
DateTimeMinutes
DateTimeMinutes(dt)
: devuelve la porción de minutos de la hora en un valor de fecha y hora.
Parámetros
dt
: datos de fecha y hora, expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
Ejemplo
DateTimeMinutes("2017-03-24 11:43:23")
devuelve 43.
DateTimeMonth
DateTimeMonth(dt)
: devuelve el valor numérico correspondiente al mes en un valor fecha y hora.
Parámetros
dt
: datos de fecha y hora expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
Ejemplo
DateTimeMonth("2017-03-24 11:43:23")
devuelve 3.
DateTimeMonth("11:43:23")
devuelve [Null] porque los datos entrantes no son válidos.
DateTimeNow
DateTimeNow()
: devuelve la fecha y hora actuales del sistema en segundos.
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()
: devuelve la fecha y hora actuales del sistema con fracciones de segundo (hasta 18 dígitos de precisión). Ten en cuenta que si solicitas una precisión más allá de lo que proporciona tu sistema operativo, la función rellena el resto con ceros como puedes ver en el segundo ejemplo.
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.
Ejemplo
DateTimeNowPrecise(3)
devuelve '2022-10-14 11:59:57.991'.
DateTimeNowPrecise(12)
devuelve '2022-10-14 11:59:57.991238400000'.
DateTimeParse
DateTimeParse(string,f,l)
: convierte una cadena de fecha con el formato (f) y el idioma (l) especificados en el formato estándar ISO (yyyy-mm-dd HH:MM:SS con precisión de fecha y hora opcional si corresponde). Si el formato especificado tiene menos precisión, la salida se trunca.
Parámetros
string
: datos de cadena de fecha y hora expresados como un campo seleccionado o una cadena de fecha y hora entre comillas. Los datos entrantes deben ser un tipo de dato de cadena y pueden estar en cualquier formato de fecha y hora, siempre y cuando este formato concuerde con el formato especificado para el parámetro f.
f
: el formato de los datos entrantes de cadena de fecha que se están convirtiendo, expresado en una cadena de formato entre comillas.
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
: (opcional) el idioma de los datos entrantes de la cadena de fecha que se están convirtiendo. El parámetro de idioma se establece de forma predeterminada en el idioma de Alteryx Designer seleccionado. Por ejemplo, si Designer se establece en francés, la función lee
DateTimeParse(string,f,"Français")
de forma predeterminada. Consulta
Parámetros de idioma
para conocer los valores de idioma aceptados.
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.
Ejemplo
DateTimeParse("2016/28-03","%Y/%d-%m")
devuelve 2016-03-28.
DateTimeParse([DateTimeNow],"%A %d %B %Y", "Français")
devuelve 2020-07-14, donde la cadena de fecha entrante es “mardi 14 juillet 2020” (martes 14 de julio de 2020).
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S')
devuelve '2022-10-04 11:59:57'. La función elimina los dígitos finales.
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S.%3')
devuelve '2022-10-04 11:59:57.990'. La función agrega ceros para que coincida con el formato %3.
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S,%3')
devuelve '2022-10-04 11:59:57.000' y una advertencia que ',' en lugar de '.' se esperaba.
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]
: devuelve el valor numérico correspondiente al trimestre del año en el que cae un valor fecha y hora (YYYY-MM-DD). Utiliza el parámetro numérico opcional para indicar el mes de inicio del primer trimestre (Q1).
Parámetros
dt
: datos de fecha y hora expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
Q1Start
: utiliza el parámetro numérico opcional para indicar el mes de inicio del primer trimestre (1-12).
Ejemplo
DateTimeQuarter("2023-01-03")
devuelve 1. No hay error porque el segundo parámetro es opcional.
DateTimeQuarter("2023-05-03", 1)
devuelve 2.
DateTimeQuarter("2023-05-03", 7)
devuelve 4. El parámetro opcional indica que el primer trimestre comienza en julio.
DateTimeQuarter("2023-05-03 12:04:55", 7)
devuelve 4. El parámetro opcional indica que el primer trimestre comienza en julio, la marca de tiempo se ignora.
DateTimeQuarter("2023-01-03", 13)
devuelve Null. El segundo parámetro debe ser un valor numérico entre 1 y 12.
DateTimeQuarter("2023-01-03", 0)
devuelve Null. El segundo parámetro debe ser un valor numérico entre 1 y 12.
DateTimeQuarter("2023-01-03", -1)
devuelve Null. El segundo parámetro debe ser un valor numérico entre 1 y 12.
DateTimeQuarter("12:00:55")
devuelve Null.
DateTimeSeconds
DateTimeSeconds(dt)
: devuelve la parte de los segundos de la hora en un valor de fecha y hora, incluida cualquier precisión de subsegundos, si corresponde.
Parámetros
dt
: datos de fecha y hora expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
Ejemplo
DateTimeSeconds('11:59:57.99')
devuelve 57.99.
DateTimeSeconds('11:59:57')
devuelve 57.
DateTimeStart
DateTimeStart()
: devuelve la fecha y hora en que el flujo de trabajo actual comenzó a ejecutarse.
DateTimeToday
DateTimeToday()
: devuelve la fecha de hoy.
Comportamiento esperado: tipo de dato de DateTimeToday
A pesar de su nombre,
DateTimeToday()
no devuelve un valor de hora. En su lugar, solo devuelve el valor de fecha con la fecha actual. Puedes envolver la función
DateTimeToday()
en la función
ToDateTime()
para devolver un valor de fecha y hora con la hora establecida a la medianoche del día actual:
ToDateTime(DateTimeToday())
DateTimeToLocal
DateTimeToLocal(dt)
: convierte datos de fecha y hora UTC a la zona horaria del sistema local. La función DateTimeToLocal actualmente no admite la precisión de fecha y hora en el 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.
Parámetros
dt
: datos de fecha y hora expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
tz:
This is an optional time zone parameter to convert the date-time to. If (tz) is not provided in the function call, the system time zone is used.
Ejemplo
DateTimeToLocal('2014-08-01 20:01:25')
devuelve la zona horaria del sistema local (hora de la montaña) como 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)
: convierte una fecha y hora (en la zona horaria del sistema local) a UTC. La función DateTimeToUTC actualmente no admite precisión de fecha y hora en el 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.
Parámetros
dt
: datos de fecha y hora expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
tz
: This is an optional time zone parameter. If the tz is not given in the function call, the system time zone is used.
Ejemplo
DateTimeToUTC(DateTimeNow())
devuelve la hora universal coordinada del tiempo de ejecución del flujo de trabajo: 2014-08-01 20:01:25 (donde la hora local, hora de la montaña, 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)
: quita las porciones no deseadas de un valor de fecha y hora, y devuelve la fecha y hora modificadas.
Parámetros
dt
: datos de fecha y hora expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
t
: tipo de recorte. Las opciones incluyen:
firstofmonth : recortar hasta principios de mes (esto hace lo mismo que “month”).
lastofmonth : extender a un segundo antes del fin del último día del mes.
year : recortar hasta la medianoche del 1 de enero.
month : recortar hasta la medianoche del primer día del mes.
day : recortar hasta el día (es decir, medianoche). Esto convierte una fecha y hora en un día con un horario cero (no una fecha).
hour : recortar hasta la hora.
minute : recortar hasta el minuto.
seconds : recortar las comillas de segundos y segundos fracciones utilizando palabras clave de la sección Palabras clave para unidades de fecha y hora .
Recortar un valor de fecha y hora no devuelve un valor redondeado. Por ejemplo, la hora 15:59:59 recortada a la hora se convierte en 15:00:00, no 16:00:00.
Ejemplo
DateTimeTrim("2016-12-07 16:03:00","year")
devuelve 2016-01-01 00:00:00.
DateTimeTrim('2016-12-07 11:59:57.99','msec')
devuelve 11:59:57.990.
DateTimeTrim('2016-12-07 11:59:57.99',4)
devuelve 11:59:57.9900.
DateTimeTrim('2016-12-07 11:59:57.123456789','milliseconds')
devuelve 11:59:57.123.
DateTimeYear
DateTimeYear(dt)
: devuelve el valor numérico correspondiente al año en un valor de fecha y hora.
Parámetros
dt
: datos de fecha y hora expresados como una columna seleccionada o un valor especificado de fecha y hora entre comillas.
Ejemplo
DateTimeYear("2017-03-24 11:43:23")
devuelve 2017.
ToDate
ToDate(x)
: convierte una cadena, un número o una fecha y hora en una fecha.
Una cadena entrante debe tener el formato YYYY-MM-DD. Por ejemplo, 2020-10-31.
Un número entrante debe tener el formato de fecha de Excel, en el que el número representa la cantidad de días desde el 01-01-1900. Por ejemplo, 7000 corresponde a 03-01-1919.
Una fecha y hora entrante debe tener el formato YYYY-MM-DD hh:mm:ss. Por ejemplo, 2020-10-31 12:00:00.
Ejemplo
ToDate('2020-10-31')
devuelve 2020-10-31 como una fecha.
ToDate(7000)
devuelve 1919-03-01 como una fecha.
ToDate('2020-10-31 12:00:00')
devuelve 2020-10-31 como una fecha.
ToDateTime
ToDateTime(x)
: convierte una cadena, un número o una fecha en un valor de fecha y hora. La función ToDateTime no admite una precisión mayor que los segundos. Limita los valores de Excel a la representación de segundos (5 dígitos, hasta 99999).
Una cadena entrante debe tener el formato YYYY-MM-DD hh:mm:ss. Por ejemplo, 2020-10-31 12:00:00.
Un número entrante debe tener el formato de fecha y hora de Excel, en el que el número representa la cantidad de días desde el 01-01-1900. Por ejemplo, 7000.354167 corresponde a 03-01-1919 a las 08:30 AM.
Ejemplo
ToDateTime('2020-10-31')
devuelve 2020-10-31 00:00:00 como un valor de fecha y hora.
ToDateTime(7000.354167)
devuelve 1919-03-01 08:30:00 como un valor de fecha y hora.
ToDateTime('2020-10-31 12:00:00')
devuelve 2020-10-31 12:00:00 como un valor de fecha y hora.
Date-Time Function Reference
Refer to these specifiers, separators, keywords, and language parameters for use in date-time functions.
Especificadores
Los especificadores siempre comienzan con un signo de porcentaje (%), seguido por una letra que distingue mayúsculas y minúsculas o un número. Los datos deben incluir al menos un año de dos dígitos.
Especificador | Salida de DateTimeFormat | Entrada compatible 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...
|
| Los cuatro dígitos del año (“2016”). | Se leen 2 o 4 dígitos. 2 dígitos se mapean a un rango del año actual menos 66 al año actual más 33. Por ejemplo, para 2016, es de 1950 a 2049. |
Month | ||
| Nombre del mes abreviado (“ene”) | Cualquier abreviatura válida de un nombre de mes (“ene”, “ENE.”). Devuelve un error solo si el texto dado no es el nombre de un mes. |
| Nombre del mes completo (“enero”) | Nombre del mes o cualquier abreviatura válida del nombre del mes (“ene”, “ENE.”). Devuelve un error solo si el texto dado no es el nombre de un mes. |
| 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. |
| Número de mes, de 01 a 12. | Número de mes con 1 o 2 dígitos, de 1 o 01 a 12. |
Week | ||
| Esto devuelve el número de semana, como 00 – 53, con el comienzo de las semanas siendo domingo. | No disponible |
| Esto devuelve el número de semana, como 00 – 53, con el comienzo de las semanas siendo lunes. | No disponible |
Day of the Year/Month | ||
| Día del mes (“01”) | 1 o 2 dígitos, ignorando espacios (“1” o “01”). |
| Día del mes, con el 0 en el comienzo reemplazado por un espacio (“ 1”). | 1 o 2 dígitos, ignorando espacios (“1” o “01”). |
| El día del año, de 001 a 365 (o 366 en años bisiestos) | Día del año de 3 dígitos, de 001 a 365 (o 366 en años bisiestos) |
Day of the Week | ||
| Nombre del día de la semana abreviado (“dom”) | Cualquier abreviatura válida de un día de la semana (“dom”, “Mar.”, “Jue”). Devuelve un error solo si el texto dado no es un día de la semana. Ten en cuenta que Alteryx no comprueba que el nombre de día especificado sea válido para la fecha determinada. |
| Nombre completo del día de la semana (“domingo”) | Nombre del día o cualquier abreviatura válida de un día de la semana (“dom”, “Mar.”, “Jue”). Devuelve un error solo si el texto dado no es un día de la semana. Ten en cuenta que Alteryx no comprueba que el nombre de día especificado sea válido para la fecha determinada. |
| Día de la semana como decimal, de 1 a 7, con el lunes siendo 1. | No disponible |
| Día de la semana como número, de 0 a 6, con el domingo siendo 0. | No disponible |
Hour, Minute, Second | ||
| Hora de reloj de 24 horas, de 00 a 23. | Hasta 2 dígitos para la hora, de 0 a 23. No compatible con %p ni %P. |
| Hora de reloj de 12 horas, de 01 a 12. | Hasta 2 dígitos para la hora, de 1 a 12. Debe seguir con %p o %P. |
| 24 horas, con el cero en el comienzo como espacio, de “ 0” a “23”. | Hasta 2 dígitos para la hora. |
| Minutos, 00 a 59 | Hasta 2 dígitos para los minutos. |
| Segundos, 00 a 59 | Hasta 2 dígitos para los segundos. |
Miscellaneous | ||
| El número de dígitos de precisión para subsegundos. | Hasta 18 dígitos de precisión para subsegundos. |
| Fecha y hora de la región de la computadora. | No disponible |
| El número del siglo (“20”) | No disponible |
| Equivalente a %m/%d/%y | No disponible |
| Igual que %b (“ene”) | Cualquier abreviatura válida de un nombre de mes (“ene”, “ENE.”). Devuelve un error solo si el texto dado no es el nombre de un mes. |
| 12 horas, con el cero en el comienzo como espacio, de “ 1” a “12”. | No disponible |
| "AM" o "PM" | No distingue mayúsculas y minúsculas ("aM" o "Pm"). Debe seguir %I (“i” mayúscula, hora en formato de 12 horas). |
| "am" o "pm" | No distingue mayúsculas y minúsculas ("aM" o "Pm"). Debe seguir %I (“i” mayúscula, hora en formato de 12 horas). |
| Hora en notación de 24 horas. Equivalente a %H:%M:%S | No disponible |
| La fecha para la región de la computadora. | No disponible |
| La hora de reloj de 12 horas, lo que incluye AM o PM (“11:51:02 AM”). | Horas: minutos: segundos [AM/PM] |
| Diferencia de horario UTC (“-600”). | No disponible |
| Nombre completo de la zona horaria (“hora estándar de la montaña”). | No disponible |
Separadores
Los separadores se insertan entre especificadores de fecha y hora para formar una cadena de formato.
Separador | Salida de DateTimeFormat | Entrada compatible con DateTimeParse * |
---|---|---|
| / | / o - |
| - | / o - |
Espacio | Un espacio | Cualquier secuencia de caracteres de espacio en blanco. |
| Una línea nueva | No disponible |
| Una tabulación | No disponible |
Otros | Otros caracteres, como coma, punto y dos puntos. | Otros caracteres, como coma, punto y dos puntos. |
* DateTimeParse acepta barras diagonales (/) y guiones (-) de manera intercambiable. Sin embargo, las comas, los dos puntos y todos los demás separadores deben coincidir exactamente con los datos entrantes.
Palabras clave para unidades de fecha y hora
Estas palabras clave son compatibles con las funciones DateTimeAdd, DateTimeDiff y DateTimeTrim. Las palabras clave no distinguen entre mayúsculas y minúsculas. Las palabras clave aceptadas para cada unidad se separan por comas.
En algunos casos, aceptamos abreviaturas hasta la palabra clave completa. Estos se especifican con la palabra
upto
en la siguiente lista y van desde la abreviatura aceptable más corta hasta la palabra clave completa. Por ejemplo, para segundos aceptamos
sec
y
seconds
, además de cualquier forma intermedia, como
seco
. Ten en cuenta que las palabras clave están en inglés y no se admite la traducción a otros idiomas.
También puedes utilizar valores numéricos como palabras clave para tiempos inferiores a los segundos. Esto incluye unidades que no se especifican concretamente en la lista que aparece a continuación. Por ejemplo, puedes usar la palabra clave “10” para indicar 10 dígitos de precisión.
yea hasta years
mon hasta months
day, days
hou hasta hours
min hasta minutes
sec hasta 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
Para ver algunos ejemplos de tamaño de campo de fecha y hora en varias unidades de precisión, consulta este tabla:
Nombre | Abreviatura | Tamaño de Fecha y hora | Ejemplo |
---|---|---|---|
Segundos |
| 19 (predeterminado) | 2023-02-24 01:23:45 |
Decisegundos (1) |
| 21 (19 + 1 + 1) | 2023-02-24 01:23:45.1 |
Centisegundos (2) |
| 22 (19 + 1 + 2) | 2023-02-24 01:23:45.12 |
Milisegundos (3) |
| 23 (19 + 1 + 3) | 2023-02-24 01:23:45.123 |
Microsegundos (6) |
| 26 (19 + 1 + 6) | 2023-02-24 01:23:45.123456 |
Nanosegundos (9) |
| 29 (19 + 1 + 9) | 2023-02-24 01:23:45.123456789 |
Picosegundos (12) |
| 32 (19 + 1 + 12) | 2023-02-24 01:23:45.123456789012 |
Femtosegundos (15) |
| 35 (19 + 1 + 15) | 2023-02-24 01:23:45.123456789012345 |
Attoseconds (18) |
| 38 (19 + 1 + 18) | 2023-02-24 01:23:45.123456789012345678 |
Parámetros de idioma
Estos son los valores compatibles para el parámetro “l” (language [idioma]) que se admite con las funciones DateTimeFormat y DateTimeParse .
Nombre del idioma en español | Nombre del idioma en lengua nativa | Código del idioma |
---|---|---|
Inglés | English | en |
Italiano | Italiano | it |
Francés | Français | fr |
Alemán | Deutsch | de |
Japonés | 日本語 | ja |
Español | Español | es |
Portugués | Português | pt |
Chino | 简体中文 | zh |
Además de los valores anteriores, también se aceptan valores con un mínimo de 2 caracteres de longitud que comiencen con cualquiera de los anteriores. Por ejemplo, “eng”, “engl”, “engli”, etc., para inglés o “esp”, “espa”, “sp”, “spa”, “span”, etc., para 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.
Aviso
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).
Sugerencia
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
Fechas admitidas
Alteryx Designer no puede procesar fechas anteriores al 1 de enero de 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.