Funções de data e hora
Uma função de data e hora executa uma ação ou cálculo em um valor de data/hora. Use funções de data e hora para adicionar ou subtrair intervalos, encontrar a data atual, encontrar o primeiro ou o último dia do mês, extrair um componente de um valor de data/hora ou converter um valor em um formato diferente.
O Alteryx usa o formato ISO yyyy-mm-dd HH:MM:SS para representar datas e horas. Para uma precisão adicional (até 18 dígitos de precisão), adicione um ponto e dígitos adicionais após a posição dos segundos. Por exemplo,
yyyy-mm-dd HH:MM:SS.5
. Se um valor de data e hora não estiver nesse formato, ele será lido como uma cadeia de caracteres. Para converter uma coluna para uso e manipulação no formato DateTime, utilize a função DateTimeParse no editor de expressões ou a
ferramenta Data e Hora
.
Date Format
Algumas funções de data e hora exigem que você defina qual é o formato da data. As cadeias de formato são compostas por especificadores e separadores.
Funções de data e hora
Consulte as funções de data e hora abaixo.
DateTimeAdd
DateTimeAdd(dt,i,u)
: adiciona um intervalo específico a um valor de data/hora.
Parâmetros
dt
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
i
: número inteiro positivo ou negativo de tempo para adicionar ou subtrair.
u
: unidade de data/hora, especificada entre aspas usando palavras-chave listadas na seção
Palavras-chave para unidades de data/hora
.
Exemplo
DateTimeAdd(DateTimeToday(), -1, "days")
retorna a data de ontem.
DateTimeAdd(DateTimeFirstOfMonth(), 1, "months")
retorna o primeiro dia do próximo mês.
DateTimeAdd("2016-01-30", 1, "month")
retorna 2016-02-29 (porque o mês de fevereiro não tem 30 dias e o último dia de fevereiro naquele ano é 29).
DateTimeAdd("2016-03-30", -1, "month")
retorna 2016-02-29 (porque o mês de fevereiro não tem 30 dias e o último dia de fevereiro naquele ano é 29).
DateTimeAdd("2016-03-30 01:02:03.000000", 495, "microseconds")
retorna 2016-03-30 01:02:03.000495.
Leia mais
Qualquer fração na duração é truncada. Por exemplo, não é possível adicionar 1,5 horas. Em vez disso, adicione 90 minutos.
Adicionar uma unidade não altera o valor das unidades menores. Por exemplo, a adição de horas não altera o valor dos minutos ou segundos. Adicionar meses não muda o dia ou a hora, a menos que o mês resultante não tenha esse dia. Nesse caso, vai para o último dia daquele mês.
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)
: retorna o valor numérico para o dia do mês em um valor de data/hora.
Parâmetros
dt
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
Exemplo
DateTimeDay("2017-03-24 11:43:23")
retorna 24.
DateTimeDiff
DateTimeDiff(dt1,dt2,u)
: subtrai o segundo argumento do primeiro e retorna a diferença entre eles como um número inteiro na unidade especificada. A duração é retornada como um número inteiro, não como uma cadeia de caracteres, nas unidades de tempo especificadas.
Parâmetros
dt
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
u
: unidade de data/hora, especificada entre aspas usando palavras-chave listadas na seção
Palavras-chave para unidades de data/hora
.
Exemplo
DateTimeDiff("2024-01-18", "2024-01-15", "days") returns 3.
DateTimeDiff("2016-02-15 00:00:00", "2016-01-15 00:00:01", "Months")
retorna 1 (porque a data inicial e final estão no mesmo dia do mês).
DateTimeDiff("2012-02-29","2011-03-01","years")
retorna 0 (porque apesar de 2012-02-29 ser 365 dias depois de 2011-03-01, o dia 29 de fevereiro vem antes do dia 1º de março, ou seja, entre as duas datas não se passa um ano completo).
DateTimeDiff("2016-02-14", "2016-01-15", "Months")
retorna 0 (porque o dia em fevereiro é menor que o dia em janeiro, ou seja, entre as duas datas não se passa um mês completo).
DateTimeDiff("2016-02-14 23:59:59", "2016-01-15 00:00:00", "Months")
retorna 0 (mesmo que falte só um segundo para atingir o dia que retornaria uma diferença de 1 mês).
DateTimeDiff('2017-02-28', '2016-02-29', 'Months')
retorna 11 (mesmo que 28 seja o último dia de fevereiro em 2017, ele ainda é menor que 29).
DateTimeDiff('2017-02-28 00:59:59.28139502', '2017-02-28 00:59:59.12383125', 'msecs')
retorna 157 (para is milissegundos entre os valores de data/hora).
Leia mais
Para diferenças de mês e ano, um mês é contado somente quando o dia final alcança o dia inicial, ignorando a hora do dia.
Para diferenças de dia, hora, minuto e segundo, o resultado é calculado com precisão e, em seguida, partes fracionárias são truncadas, não arredondadas. Por isso...
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.
Os nomes das precisões podem ser abreviados para os três primeiros caracteres (como "sec" e "min"); não há diferenciação entre maiúsculas e minúsculas.
Tenha cuidado ao retornar as diferenças de tempo em segundos. Dados do tipo Int32 só podem armazenar uma diferença de até 68 anos em segundos ou até 4082 anos em minutos. Você pode usar dados do tipo Double ou Int64 para armazenar os intervalos entre todas as datas compatíveis.
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()
: retorna o primeiro dia do mês, à meia-noite.
DateTimeFormat
DateTimeFormat(dt,f,l)
: converte dados de data/hora do formato ISO para outro formato especificado (f) em um idioma especificado (l) para uso em outro aplicativo. A saída gerada são dados do tipo cadeia de caracteres. Se o formato especificado tiver menos precisão, o resultado será truncado.
Parâmetros
dt
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
f
: o formato para o qual converter os dados, expresso como uma cadeia de formato.
l
: parâmetro opcional de idioma. O parâmetro de idioma é, por padrão, o idioma que você selecionou para o Designer. Por exemplo, se o Designer estiver definido para o francês, a função exibirá
DateTimeParse(dt,f,"Français")
por padrão. Consulte
Parâmetros de idioma
para obter os valores de idioma aceitos.
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.
Exemplo
DateTimeFormat([DateTime_Out],"%d-%m-%Y")
retorna 22-04-2008 para o dia 22 de abril de 2008 (formato ISO: 2008-04-22).
DateTimeFormat([DateTime_Out],"%A","Spanish")
retorna “martes” para a data ISO 2020-07-14 (em que 14 de julho é terça-feira).
DateTimeFormat('11:59:57.890994389','%H:%M:%S.%5')
retorna "11:59:57.89099" (o valor é truncado para 5 dígitos de precisão com base nos dígitos especificados).
DateTimeFormat('11:59:57.99','%H:%M:%S,%3')
retorna "11:59:57,990" (você pode obter o separador decimal da sua localidade. Este exemplo usa uma vírgula em vez de um ponto 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)
: retorna a parte das horas de um valor de data/hora.
Parâmetros
dt
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
Exemplo
DateTimeHour("2017-03-24 11:43:23")
retorna 11.
DateTimeHour("2017-03-24")
retorna 0, porque quando não há um horário especificado nos dados, meia-noite é a hora adotada.
DateTimeLastOfMonth
DateTimeLastOfMonth()
: retorna o último dia do mês atual, com o relógio definido para um segundo antes do final do dia (23:59:59).
O Designer usa a data de quando a fórmula é processada pela primeira vez. Em um processo em lotes, essa data é usada com cada novo conjunto de dados. Isso garante consistência caso o processo demore muito tempo.
DateTimeMinutes
DateTimeMinutes(dt)
: retorna a parte dos minutos de um valor de data/hora.
Parâmetros
dt
: dados do tipo DateTime, expressos como uma coluna selecionada ou como um valor DateTime especificado entre aspas.
Exemplo
DateTimeMinutes("2017-03-24 11:43:23")
retorna 43.
DateTimeMonth
DateTimeMonth(dt)
: retorna o valor numérico para o mês em um valor de data/hora.
Parâmetros
dt
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
Exemplo
DateTimeMonth("2017-03-24 11:43:23")
retorna 3.
DateTimeMonth("11:43:23")
retorna [Null] (nulo) porque os dados recebidos não são válidos.
DateTimeNow
DateTimeNow()
: retorna a data e a hora atuais do sistema com a precisão de 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()
: retorna a data e a hora atuais do sistema com a precisão de frações de segundo (até 18 dígitos de precisão). Observe que se você solicitar uma precisão além do que o seu sistema operacional fornece, a função preencherá o restante com zeros, como no segundo exemplo abaixo.
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.
Exemplo
DateTimeNowPrecise(3)
retorna "2022-10-14 11:59:57.991".
DateTimeNowPrecise(12)
retorna "2022-10-14 11:59:57.991238400000".
DateTimeParse
DateTimeParse(string,f,l)
: converte uma cadeia de caracteres de data (string) com o formato especificado (f) no idioma especificado (l) para o formato padrão ISO (yyyy-mm-dd HH:MM:SS, com precisão de data/hora opcional, se aplicável). Se o formato especificado tiver menos precisão, o resultado será truncado.
Parâmetros
string
: cadeia de caracteres de data/hora, expressa como um campo selecionado ou como uma cadeia de data/hora entre aspas. Os dados de entrada devem ser do tipo cadeia de caracteres e podem estar em qualquer formato de data/hora desde que esse formato coincida com o que for especificado para o parâmetro f.
f
: o formato da data/hora nos dados de cadeia de caracteres que você quer converter, expresso como uma cadeia de formato entre aspas.
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): o idioma da data/hora nos dados de cadeia de caracteres que você quer converter. O parâmetro de idioma é, por padrão, o idioma que você selecionou para o Designer. Por exemplo, se o Designer estiver definido para o francês, a função exibirá
DateTimeParse(string,f,"Français")
por padrão. Consulte
Parâmetros de idioma
para obter os valores de idioma aceitos.
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.
Exemplo
DateTimeParse("2016/28-03","%Y/%d-%m")
retorna 2016-03-28.
DateTimeParse([DateTimeNow],"%A %d %B %Y", "Français")
retorna 2020-07-14 para a cadeia de caracteres de entrada “mardi 14 juillet 2020” (terça-feira, 14 de julho de 2020).
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S')
retorna "2022-10-04 11:59:57". A função descarta os dígitos finais.
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S.%3')
retorna "2022-10-04 11:59:57.990". A função adiciona zeros para corresponder ao formato %3.
DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S,%3')
retorna "2022-10-04 11:59:57.000" e um aviso de que era esperado "," em vez 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]
: retorna o valor numérico para o trimestre do ano no qual um valor de data/hora (YYYY-MM-DD) se encontra. Use o parâmetro numérico opcional para indicar o mês de início para o primeiro trimestre (Q1).
Parâmetros
dt
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
Q1Start
: parâmetro numérico opcional para indicar o mês de início para o primeiro trimestre (1 a 12).
Exemplo
DateTimeQuarter("2023-01-03")
retorna 1. Nenhum erro porque o segundo parâmetro é opcional.
DateTimeQuarter("2023-05-03", 1)
retorna 2.
DateTimeQuarter("2023-05-03", 7)
retorna 4. O parâmetro opcional indica que o primeiro trimestre inicia em julho.
DateTimeQuarter("2023-05-03 12:04:55", 7)
retorna 4. O parâmetro opcional indica que o primeiro trimestre inicia em julho e o carimbo de data/hora é ignorado.
DateTimeQuarter("2023-01-03", 13)
retorna nulo. O segundo parâmetro deve ser um valor numérico entre 1 e 12.
DateTimeQuarter("2023-01-03", 0)
retorna nulo. O segundo parâmetro deve ser um valor numérico entre 1 e 12.
DateTimeQuarter("2023-01-03", -1)
retorna nulo. O segundo parâmetro deve ser um valor numérico entre 1 e 12.
DateTimeQuarter("12:00:55")
retorna nulo.
DateTimeSeconds
DateTimeSeconds(dt)
: retorna a parte dos segundos de um valor data/hora, incluindo qualquer nível de precisão de subsegundos, se aplicável.
Parâmetros
dt
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
Exemplo
DateTimeSeconds('11:59:57.99')
retorna 57.99.
DateTimeSeconds('11:59:57')
retorna 57.
DateTimeStart
DateTimeStart()
: retorna a data e a hora em que a execução do fluxo de trabalho atual começou.
DateTimeToday
DateTimeToday()
: retorna a data de hoje.
Comportamento esperado: tipo dos dados com DateTimeToday
Apesar do nome, a função
DateTimeToday()
não retorna um valor de hora (Time). Em vez disso, ela retorna apenas um valor de data (Date) com a data atual. Você pode encapsular a função
DateTimeToday()
dentro da função
ToDateTime()
para retornar um valor de data e hora com o horário definido para a meia-noite do dia atual:
ToDateTime(DateTimeToday())
DateTimeToLocal
DateTimeToLocal(dt)
: converte uma data/hora UTC para o fuso horário local do sistema. A função DateTimeToLocal atualmente não oferece suporte para a precisão de data/hora no 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
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
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.
Exemplo
DateTimeToLocal('2014-08-01 20:01:25')
retorna o fuso horário local do sistema como 2014-08-01 14:01:25 (supondo que o sistema esteja na Hora Padrão das Montanhas).
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 uma data/hora (no fuso horário local do sistema) para UTC. A função DateTimeToUTC atualmente não oferece suporte para a precisão de data/hora no 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
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
tz: This is an optional time zone parameter. If the tz is not given in the function call, the system time zone is used.
Exemplo
DateTimeToUTC(DateTimeNow())
retorna o Tempo Universal Coordenado (UTC) no momento da execução do fluxo de trabalho, ou seja, retorna 2014-08-01 20:01:25 caso o fluxo seja executado em 2014-08-01 14:01:25 na Hora Padrão das Montanhas.
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)
: remove partes indesejadas de uma data/hora e retorna a data/hora modificada.
Parâmetros
dt
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
t
: tipo de corte que você deseja fazer. As opções incluem:
firstofmonth : ajusta para o início do mês (faz o mesmo que “month”).
lastofmonth : ajusta para um segundo antes do final do último dia do mês.
year : ajusta para a meia-noite de 1º de janeiro.
month : ajusta para a meia-noite do primeiro dia do mês.
day : ajusta para o dia à meia-noite. Converte uma data/hora para uma data com o horário definido para zero (não somente uma data).
hour : ajusta para a hora.
minute : ajusta para o minuto.
seconds : ajusta para o segundo e a fração de segundo usando as palavras-chaves listadas na seção Palavras-chave para unidades de data/hora .
Ao usar a função trim para cortar uma data/hora, o valor retornado não é arredondado. Por exemplo, o horário 15:59:59 ajustado para a hora (t = "hour") retorna 15:00:00, não 16:00:00.
Exemplo
DateTimeTrim("2016-12-07 16:03:00","year")
retorna 2016-01-01 00:00:00.
DateTimeTrim('2016-12-07 11:59:57.99','msec')
retorna 11:59:57.990.
DateTimeTrim('2016-12-07 11:59:57.99',4)
retorna 11:59:57.9900.
DateTimeTrim('2016-12-07 11:59:57.123456789','milliseconds')
retorna 11:59:57.123.
DateTimeYear
DateTimeYear(dt)
: retorna o valor numérico para o ano em um valor de data/hora.
Parâmetros
dt
: dados do tipo data/hora, expressos como uma coluna selecionada ou como um valor de data/hora especificado entre aspas.
Exemplo
DateTimeYear("2017-03-24 11:43:23")
retorna 2017.
ToDate
ToDate(x)
: converte uma cadeia de caracteres, número ou data/hora em uma data.
Uma cadeia de caracteres de entrada deve estar formatada como yyyy-mm-dd. Por exemplo, 2020-10-31.
Um número de entrada deve estar formatado como um formato de data do Excel, em que o número representa o número de dias desde 01-01-1900. Por exemplo, 7000, que corresponde a 1º de março de 1919.
Uma data/hora de entrada deve estar formatada como yyyy-mm-dd hh:mm:ss. Por exemplo, 2020-10-31 12:00:00.
Exemplo
ToDate('2020-10-31')
retorna 2020-10-31 como uma data.
ToDate(7000)
retorna 1919-03-01 como uma data.
ToDate('2020-10-31 12:00:00')
retorna 2020-10-31 como uma data.
ToDateTime
ToDateTime(x)
: converte uma cadeia de caracteres, um número ou uma data em uma data/hora. A função ToDateTime oferece suporte à precisão superior a segundos. Limite os valores de Excel à representação de segundos (5 dígitos, até 99999).
Uma cadeia de caracteres de entrada deve estar formatada como yyyy-mm-dd hh:mm:ss. Por exemplo, 2020-10-31 12:00:00.
Um número de entrada deve estar formatado como um formato de data/hora do Excel, em que o número representa o número de dias desde 01-01-1900. Por exemplo, 7000.354167, que corresponde a 1º de março de 1919 às 08:30.
Exemplo
ToDateTime('2020-10-31')
retorna 2020-10-31 00:00:00 como uma data/hora.
ToDateTime(7000.354167)
retorna 1919-03-01 08:30:00 como uma data/hora.
ToDateTime('2020-10-31 12:00:00')
retorna 2020-10-31 12:00:00 como uma data/hora.
Date-Time Function Reference
Refer to these specifiers, separators, keywords, and language parameters for use in date-time functions.
Especificadores
Os especificadores sempre começam com um sinal de porcentagem (%) seguido por uma letra (há diferenciação entre maiúsculas e minúsculas) ou número. Os dados devem incluir pelo menos um ano de dois dígitos.
Dica
If you prefer to view an alphabetized list, you can do so below.
Especificador | Saída de DateTimeFormat | Entradas compatíveis com 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...
|
| Todos os quatro dígitos do ano (“2016”). | 2 ou 4 dígitos são lidos. 2 dígitos são mapeados para um intervalo entre o ano atual menos 66 até o ano atual mais 33. Por exemplo, em 2016, o intervalo vai de 1950 a 2049. |
Month | ||
| Nome abreviado do mês (“Set”) | Qualquer abreviação válida do nome de um mês ("Set", "SET"). Retorna um erro somente se o texto fornecido não for o nome de um mês. |
| Nome completo do mês (“Setembro”) | Nome do mês ou qualquer abreviação válida do nome de um mês ("Set", "SET"). Retorna um erro somente se o texto fornecido não for o nome de um mês. |
| 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 do mês, de 01 a 12. | Número do mês com 1 ou 2 dígitos, de 1 ou 01 até 12. |
Week | ||
| Retorna o número da semana, como 00 a 53, com o início das semanas sendo domingo. | Sem suporte |
| Retorna o número da semana, como 00 a 53, com o início das semanas sendo segunda-feira. | Sem suporte |
Day of the Year/Month | ||
| Dia do mês (“01”) | 1 ou 2 dígitos, ignorando espaços ("1" ou "01"). |
| Dia do mês, com o 0 à esquerda substituído por um espaço (“ 1”). | 1 ou 2 dígitos, ignorando espaços ("1" ou "01"). |
| O dia do ano, 001 a 365 (ou 366 em anos bissextos) | Dia do ano com 3 dígitos, de 001 a 365 (ou 366 em anos bissextos) |
Day of the Week | ||
| Nome abreviado do dia da semana (“Seg”) | Qualquer abreviação válida de um dia da semana ("seg", "ter", "qui"). Retorna um erro somente se o texto fornecido não for um dia da semana. Observe que o Alteryx não verifica se o nome do dia especificado é válido para uma determinada data. |
| Nome completo do dia da semana (“Segunda-feira”) | Nome do dia ou qualquer abreviação válida de um dia da semana ("seg", "ter", "qui"). Retorna um erro somente se o texto fornecido não for um dia da semana. Observe que o Alteryx não verifica se o nome do dia especificado é válido para uma determinada data. |
| Dia da semana como um decimal de 1 a 7, com a segunda-feira sendo 1. | Sem suporte |
| Dia da semana como um número de 0 a 6, com o domingo sendo 0. | Sem suporte |
Hour, Minute, Second | ||
| Hora no relógio de 24 horas, de 00 a 23. | Até 2 dígitos para a hora, de 0 a 23. Não é compatível com %p ou %P. |
| Hora no relógio de 12 horas, de 01 a 12. | Até 2 dígitos para a hora, de 1 a 12. Deve ser seguido por %p ou %P. |
| 24 horas, o zero à esquerda é um espaço, de “ 0” a “23”. | Até 2 dígitos para a hora. |
| Minutos, 00 a 59 | Até 2 dígitos para os minutos. |
| Segundos, 00 a 59 | Até 2 dígitos para os segundos. |
Miscellaneous | ||
| O número de dígitos de precisão para sub-segundos. | Até 18 dígitos de precisão para sub-segundos. |
| A data e a hora da localidade do computador. | Sem suporte |
| O número do século (“20”) | Sem suporte |
| Equivalente a %m/%d/%y | Sem suporte |
| O mesmo que %b (“Set”) | Qualquer abreviação válida do nome de um mês ("Set", "SET"). Retorna um erro somente se o texto fornecido não for o nome de um mês. |
| 12 horas, o zero à esquerda é um espaço, de “ 1” a “12”. | Sem suporte |
| "AM" ou "PM" | Não diferencia maiúsculas e minúsculas ("aM" ou "Pm"). Deve vir após %I (letra "i" maiúscula, hora no formato 12 horas). |
| "am" ou "pm" | Não diferencia maiúsculas e minúsculas ("aM" ou "Pm"). Deve vir após %I (letra "i" maiúscula, hora no formato 12 horas). |
| Tempo em notação de 24 horas. Equivalente a %H:%M:%S | Sem suporte |
| A data da localidade do computador. | Sem suporte |
| Tempo como no relógio de 12 horas, incluindo AM ou PM (“11:51:02 AM”). | Horas:Minutos:Segundos [AM / PM] |
| Diferença do horário UTC (“-600”). | Sem suporte |
| Nome completo do fuso horário (por exemplo, “Horário Padrão de Brasília"). | Sem suporte |
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. |
Separadores
Os separadores são inseridos entre os especificadores de data/hora para criar uma cadeia de formato.
Separador | Saída de DateTimeFormat | Entradas compatíveis com DateTimeParse* |
|---|---|---|
| / | / ou - |
| - | / ou - |
espaço | Um espaço | Qualquer sequência de espaços em branco. |
| Uma nova linha | Sem suporte |
| Uma tabulação | Sem suporte |
outros | Outros caracteres, como vírgula, ponto final e dois-pontos. | Outros caracteres, como vírgula, ponto final e dois-pontos. |
*DateTimeParse aceita barras ( / ) e hífens ( - ) de maneira intercambiável. No entanto, vírgulas, dois-pontos e todos os outros separadores devem corresponder exatamente aos dados recebidos.
Palavras-chave para unidades de data/hora
Estas palavras-chave são compatíveis com as funções DateTimeAdd, DateTimeDiff e DateTimeTrim. Não há diferenciação de maiúsculas e minúsculas nas palavras-chave. As palavras-chave aceitas para cada unidade estão separadas por vírgulas.
Em alguns casos, aceitamos desde a abreviação até a palavra completa. Esses casos estão especificados na lista abaixo com a palavra
até
e variam da abreviatura mais curta aceitável até a palavra-chave completa. Por exemplo, para os segundos aceitamos
sec
e
seconds
, bem como qualquer variação entre as duas formas, como
seco
. Observe que as palavras-chave estão em inglês e a tradução para outros idiomas não é compatível.
Você também pode usar valores numéricos como palavras-chave para o tempo de sub-segundos. Isso inclui unidades que não estão especificamente mencionadas na lista abaixo. Por exemplo, você pode usar a palavra-chave "10" para indicar 10 dígitos de precisão.
yea até yearsmon até monthsday, dayshou até hoursmin até minutessec até 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
Para alguns exemplos do tamanho do campo DateTime em diferentes unidades de precisão, consulte esta tabela:
Nome | Abreviatura | Tamanho do campo DateTime | Exemplo |
|---|---|---|---|
Segundos |
| 19 (padrão) | 2023-02-24 01:23:45 |
Decissegundos (1) |
| 21 (19 + 1 + 1) | 2023-02-24 01:23:45.1 |
Centissegundos (2) |
| 22 (19 + 1 + 2) | 2023-02-24 01:23:45.12 |
Milissegundos (3) |
| 23 (19 + 1 + 3) | 2023-02-24 01:23:45.123 |
Microssegundos (6) |
| 26 (19 + 1 + 6) | 2023-02-24 01:23:45.123456 |
Nanossegundos (9) |
| 29 (19 + 1 + 9) | 2023-02-24 01:23:45.123456789 |
Picossegundos (12) |
| 32 (19 + 1 + 12) | 2023-02-24 01:23:45.123456789012 |
Femtossegundos (15) |
| 35 (19 + 1 + 15) | 2023-02-24 01:23:45.123456789012345 |
Attossegundos (18) |
| 38 (19 + 1 + 18) | 2023-02-24 01:23:45.123456789012345678 |
Parâmetros de idioma
Estes são os valores compatíveis com o parâmetro "l" (idioma), que pode ser usado com as funções DateTimeFormat e DateTimeParse .
Nome do idioma em inglês | Nome do idioma na língua nativa | Código do idioma |
|---|---|---|
Inglês | English | en |
Italiano | Italiano | it |
Francês | Français | fr |
Alemão | Deutsch | de |
Japonês | 日本語 | ja |
Espanhol | Español | es |
Português | Português | pt |
Chinês | 简体中文 | zh |
Além dos valores acima, valores que tenham pelo menos 2 caracteres de comprimento e que comecem como qualquer dos nomes acima também são aceitáveis. Por exemplo, eng, engl, engli etc. para o idioma inglês, ou esp, espa, sp, spa, span etc. para o espanhol.
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.
Atenção
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).
Dica
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
Suporte a datas
O Designer não pode processar datas anteriores a 1º de janeiro 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.