# Funções de datas

Caso os dados não sejam detectados como data, você precisa primeiro aplicar a função Converter em data à coluna com datas antes de aplicar qualquer outra função relacionada a datas. As informações de formato que você precisa preencher são apenas para configurar o formato do texto de exibição da data, não para analisar um texto não detectado como data.

## Adicionar duração

Adiciona a duração a uma data, hora ou carimbo de data/hora, na unidade de tempo especificada.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Unidade de tempo | Selecione a qual parte da data, hora ou carimbo de data/hora você deseja adicionar a hora:<br><br><ul> <li> <p>Ano</p> </li> <li> <p>Mês</p> </li> <li> <p>Semana</p> </li> <li> <p>Dia</p> </li> <li> <p>Hora</p> </li> <li> <p>Minuto</p> </li> <li> <p>Segundo</p> </li> <li> <p>Milissegundo</p> </li> <li> <p>Microsegundo</p> </li> </ul> |
| Usar com | <ul> <li> <p><span>Valor</span>: selecione esta opção para adicionar um valor fixo, definido no campo <span>Valor</span>.</p> </li> <li> <p><span>Outra coluna</span>: selecione esta opção para adicionar um valor de outra coluna, definida na lista suspensa <span>Coluna</span>.</p> </li> </ul> |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| 03/03/2023 | <ul> <li> <p>Unidade de tempo: Ano</p> </li> <li> <p>Usar com: Valor</p> </li> <li> <p>Valor: 10</p> </li> </ul> | 03/03/2033 |
| 3/7/2019 2:00:00 PM | <ul> <li> <p>Unidade de tempo: Segundos</p> </li> <li> <p>Usar com: Valor</p> </li> <li> <p>Valor: 30</p> </li> </ul> | 3/7/2019 2:00:30 PM |

## Calcular diferença de data

Para uma determinada unidade de tempo, calcula o tempo entre as datas na sua coluna e a data escolhida.

O cálculo é feito primeiro truncando as datas para a data ou hora especificada e, em seguida, retornando a diferença entre elas como um inteiro.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Unidade de tempo | Selecione a parte do tempo a ser usada para o cálculo:<br><br><ul> <li> <p>Ano</p> </li> <li> <p>Mês</p> </li> <li> <p>Dia</p> </li> <li> <p>Hora</p> </li> <li> <p>Minuto</p> </li> <li> <p>Segundo</p> </li> <li> <p>Milissegundo</p> </li> <li> <p>Microsegundo</p> </li> </ul> |
| Até | Selecione como você deseja definir a data como alvo:<br><br><ul> <li> <p><span>Agora</span>, você pode calcular a diferença até a data e a hora atuais.</p> </li> <li> <p><span>Data específica</span> para inserir a data de sua escolha, definida usando o seletor de data no campo <span>Esta data</span>.</p> </li> <li> <p><span>Outra coluna</span> para usar datas de outra coluna, definida na lista suspensa <span>Coluna</span>.</p> </li> </ul> |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| 06/12/1989 | <ul> <li> <p>Unidade de tempo: Dia</p> </li> <li> <p>Até: Data específica</p> </li> <li> <p>Esta data: 31/12/2000</p> </li> </ul> | 4044 |
| <ul> <li> <p>Coluna A: 8/4/2016</p> </li> <li> <p>Coluna B: 8/4/2025</p> </li> </ul> | <ul> <li> <p>Tempo até: Semana</p> </li> <li> <p>Até: Outra coluna</p> </li> <li> <p>Coluna: B</p> </li> </ul> | 468 |

## Comparar datas

Compara as datas na coluna com um valor específico ou valores de outra coluna. A função retornará TRUE se a condição definida pelo operador for atendida; caso contrário, retornará FALSE.

As horas só podem ser comparadas com as horas, mas os carimbos de data/hora e as datas podem ser comparados. Nesse caso, uma data será interpretada como um carimbo de data/hora com a hora definida como 00:00.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Modo de comparação | Selecione o operador que será usado para comparar as datas.<br><br><ul> <li> <p>Igual</p> </li> <li> <p>Diferente de</p> </li> <li> <p>Após</p> </li> <li> <p>Após ou igual</p> </li> <li> <p>Antes</p> </li> <li> <p>Antes ou igual</p> </li> </ul> |
| Usar com | <ul> <li> <p><span>Valor</span>: selecione esta opção para verificar a coluna em relação a um valor fixo, definido com o seletor de data <span>Valor</span>. Selecione as datas no formato mm/dd/aaaa.</p> <div><span>Nota informativa</span>Se você configurou esta função anteriormente com uma data fixa em um formato diferente, serão feitas tentativas para analisar a entrada e exibi-la corretamente no novo campo de data. No entanto, se você vir uma entrada vazia, pode ser necessário reconfigurar o <span>Valor</span>.</div> </li> <li> <p><span>Outra coluna</span>: selecione esta opção para verificar a coluna em relação aos valores de outra coluna, definida na lista suspensa <span>Coluna</span>.</p> </li> </ul> |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| <ul> <li> <p>1969-02-27</p> </li> <li> <p>1989-11-09</p> </li> </ul> | <ul> <li> <p>Modo de comparação: Após</p> </li> <li> <p>Usar com: Valor</p> </li> <li> <p>Valor: 01/01/1989</p> </li> </ul> | <ul> <li> <p>FALSE</p> </li> <li> <p>TRUE</p> </li> </ul> |

## Converter em data

Converte o tipo de dado contido na coluna para que seja interpretado como datas no sistema.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Formato de data | Selecione o formato de data esperado para a coluna.<br><br><ul> <li> <p>Auto, para detectar automaticamente o formato atual.</p> </li> <li> <p>Personalizado, para inserir seu formato de data específico, definido no campo <span>Padrão de data</span>.</p> </li> <li> <p>AAAA-MM-DD</p> </li> <li> <p>AAAAMMDD</p> </li> <li> <p>M/D/AAAA</p> </li> <li> <p>M/D/AA</p> </li> <li> <p>MM/DD/AA</p> </li> <li> <p>MMM D, AAAA</p> </li> <li> <p>MMMM D,&nbsp;AAAA</p> </li> </ul> |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

## Converter em hora

Converte o tipo de dado contido na coluna para que seja interpretado como hora no sistema.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Formato de data | Selecione o formato de hora esperado para a coluna.<br><br><ul> <li> <p>Auto, para detectar automaticamente o formato atual.</p> </li> <li> <p>Personalizado, para inserir seu formato de hora específico, definido no campo <span>Padrão de data</span>.</p> </li> <li> <p>hh:mm</p> </li> <li> <p>hh:mm:ss</p> </li> <li> <p>hh:mm AM/PM</p> </li> <li> <p>hh:mm:ss AM/PM</p> </li> </ul> |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

## Converter em carimbo de data/hora

Converte o tipo de dado contido na coluna para que seja interpretado como carimbo de data/hora no sistema.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Formato de data | Selecione o formato de carimbo de data/hora esperado para a coluna.<br><br><ul> <li> <p>Auto, para detectar automaticamente o formato atual.</p> </li> <li> <p>Personalizado, para inserir seu formato de carimbo de data/hora específico, definido no campo <span>Padrão de data</span>.</p> </li> <li> <p>AAAAMMDD hh:mm</p> </li> <li> <p>AAAAMMDD hh:mm:ss</p> </li> <li> <p>AAAAMMDDThh:mm</p> </li> <li> <p>AAAAMMDDThh:mm:ss</p> </li> <li> <p>M/D/AAAA hh:mm AM/PM</p> </li> <li> <p>M/D/AA hh:mm&nbsp;AM/PM</p> </li> <li> <p>MM/DD/AA hh:mm AM/PM</p> </li> <li> <p>M/D/AAAA hh:mm:ss&nbsp;AM/PM</p> </li> <li> <p>M/D/AA hh:mm:ss AM/PM</p> </li> <li> <p>MM/DD/AA HH:mm:ss&nbsp;AM/PM</p> </li> <li> <p>MMM D, AAAA hh:mm:ss AM/PM</p> </li> <li> <p>Dia da semana, MMMM D, AAAA hh:mm:ss&nbsp;AM/PM</p> </li> </ul> |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

## Criar data a partir de partes

Cria uma nova coluna de data concatenando partes numéricas de outras colunas.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Ano | Selecione a coluna que contém as informações com o ano para a data que você deseja criar. |
| Mês | Selecione a coluna que contém as informações com o mês para a data que você deseja criar. |
| Dia | Selecione a coluna que contém as informações com o dia para a data que você deseja criar. |
| Nome da nova coluna | Digite o nome da coluna que será criada para a concatenação. Se você não inserir um novo nome, o nome da coluna padrão será `new_date`. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| <ul> <li> <p>Coluna A: 10</p> </li> <li> <p>Coluna B:&nbsp;2021</p> </li> <li> <p>Coluna C: 12</p> </li> </ul> | <ul> <li> <p>Ano: Coluna B</p> </li> <li> <p>Mês: Coluna A</p> </li> <li> <p>Dia: Coluna C</p> </li> </ul> | Coluna D: 10/21/2021 |

## Criar horário a partir de partes

Cria uma nova coluna de hora concatenando partes numéricas de outras colunas.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Hora | Selecione a coluna que contém as informações com as horas para a hora que você deseja criar. |
| Minuto | Selecione a coluna que contém as informações com os minutos para a hora que você deseja criar. |
| Segundo | Selecione a coluna que contém as informações com os segundos para a hora que você deseja criar. |
| Milissegundo | Selecione a coluna que contém as informações com os milissegundos para a hora que você deseja criar. |
| Nome da nova coluna | Digite o nome da coluna que será criada para a concatenação. Se você não inserir um novo nome, o nome da coluna padrão será `new_time`. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| <ul> <li> <p>Coluna A: 9</p> </li> <li> <p>Coluna B: 1</p> </li> <li> <p>Coluna C:&nbsp;30</p> </li> <li> <p>Coluna D: 56</p> </li> </ul> | <ul> <li> <p>Hora: Coluna A</p> </li> <li> <p>Minuto: Coluna D</p> </li> <li> <p>Segundo: Coluna C</p> </li> <li> <p>Milissegundo: Coluna B</p> </li> </ul> | Coluna E: 09:56:30.100 |

## Criar carimbo de data/hora a partir de partes

Cria uma nova coluna de carimbo de data/hora concatenando partes numéricas de outras colunas.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Ano | Selecione a coluna que contém as informações com o ano para o carimbo de data/hora que você deseja criar. |
| Mês | Selecione a coluna que contém as informações com o mês para o carimbo de data/hora que você deseja criar. |
| Dia | Selecione a coluna que contém as informações com o dia para o carimbo de data/hora que você deseja criar. |
| Hora | Selecione a coluna que contém as informações com as horas para o carimbo de data/hora que você deseja criar. |
| Minuto | Selecione a coluna que contém as informações com os minutos para o carimbo de data/hora que você deseja criar. |
| Segundo | Selecione a coluna que contém as informações com os segundos para o carimbo de data/hora que você deseja criar. |
| Milissegundo | Selecione a coluna que contém as informações com os milissegundos para o carimbo de data/hora que você deseja criar. |
| Nome da nova coluna | Digite o nome da coluna que será criada para a concatenação. Se você não inserir um novo nome, o nome da coluna padrão será `new_timestamp`. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| <ul> <li> <p>Coluna A: 10</p> </li> <li> <p>Coluna B: 2021</p> </li> <li> <p>Coluna C: 12</p> </li> <li> <p>Coluna D: 9</p> </li> <li> <p>Coluna E: 1</p> </li> <li> <p>Coluna F: 30</p> </li> <li> <p>Coluna G: 56</p> </li> </ul> | <ul> <li> <p>Ano: Coluna B</p> </li> <li> <p>Mês: Coluna A</p> </li> <li> <p>Dia: Coluna C</p> </li> <li> <p>Hora: Coluna D</p> </li> <li> <p>Minuto: Coluna G</p> </li> <li> <p>Segundo: Coluna F</p> </li> <li> <p>Milissegundo: Coluna E</p> <p>&nbsp;</p> </li> </ul> | Coluna H: 10/12/2021 9:56:30 AM |

## Extrair partes da data

Extrai partes de uma data e cria colunas separadas com as partes selecionadas.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| <ul> <li> <p><span>AM/PM</span> </p> </li> <li> <p><span>Dia</span> </p> </li> <li> <p><span>Nome do dia</span> </p> </li> <li> <p><span>Dia da semana</span> </p> </li> <li> <p><span>Dia do ano</span> </p> </li> <li> <p><span>Hora (relógio de 12 horas)</span> </p> </li> <li> <p><span>Hora (relógio de 24 horas)</span> </p> </li> <li> <p><span>Minuto</span> </p> </li> <li> <p><span>Mês</span> </p> </li> <li> <p><span>Nome do mês</span> </p> </li> <li> <p><span>Trimestre do ano</span> </p> </li> <li> <p><span>Número do trimestre</span> </p> </li> <li> <p><span>Segundo</span> </p> </li> <li> <p><span>Semana</span> </p> </li> <li> <p><span>Ano</span> </p> </li> <li> <p><span>Ano-Mês</span> </p> </li> <li> <p><span>Ano-Trimestre</span> </p> </li> <li> <p><span>Ano-Semana</span> </p> </li> </ul> | Selecione quais colunas serão criadas usando as opções. Cada parte selecionada será extraída em uma coluna diferente. O nome padrão da coluna será `<prefix_or_source_column_name>_<date_part>`. |
| Prefixo da parte da data | Digite um prefixo personalizado que será adicionado ao nome de cada coluna criada. Se você não especificar um prefixo, o nome da coluna de origem com as datas será usado como prefixo. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| 10/12/2021 9:56:30 AM | <ul> <li> <p>Nome do dia</p> </li> <li> <p>Dia da semana</p> </li> <li> <p>Nome do mês</p> </li> <li> <p>Trimestre do ano</p> </li> <li> <p>Semana</p> </li> <li> <p>Prefixo da parte da data: extraído</p> </li> </ul> | <ul> <li> <p>extracted_dayLabel: Thu</p> </li> <li> <p>extracted_dayOfWeek: 4</p> </li> <li> <p>extracted_monthLabel: Oct</p> </li> <li> <p>extracted_quarterLabel: Q4</p> </li> <li> <p>extracted_weekOfYear: 43</p> </li> </ul> |

## Formatar data

Altera o formato de data a ser usado em uma coluna de data.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Formato de data | Selecione um dos formatos predefinidos na lista suspensa ou insira um formato personalizado para aplicar às datas:<br><br><ul> <li> <p>Personalizado, para inserir seu formato de data específico, definido no campo <span>Padrão de data</span>.</p> </li> <li> <p>AAAA-MM-DD</p> </li> <li> <p>AAAAMMDD</p> </li> <li> <p>M/D/AAAA</p> </li> <li> <p>M/D/AA</p> </li> <li> <p>MM/DD/AA</p> </li> <li> <p>MMM D, AAAA</p> </li> <li> <p>MMMM D, AAAA</p> </li> <li> <p>AAAAMMDD hh:mm</p> </li> <li> <p>AAAAMMDD hh:mm:ss</p> </li> <li> <p>AAAAMMDDThh:mm</p> </li> <li> <p>AAAAMMDDThh:mm:ss</p> </li> <li> <p>M/D/AAAA hh:mm AM/PM</p> </li> <li> <p>M/D/AA hh:mm&nbsp;AM/PM</p> </li> <li> <p>MM/DD/AA hh:mm AM/PM</p> </li> <li> <p>M/D/AAAA hh:mm:ss AM/PM</p> </li> <li> <p>M/D/AA hh:mm:ss AM/PM</p> </li> <li> <p>MM/DD/AA HH:mm:ss AM/PM</p> </li> <li> <p>MMM D, AAAA hh:mm:ss AM/PM</p> </li> <li> <p>Dia da semana, MMMM D, AAAA hh:mm:ss&nbsp;AM/PM</p> </li> <li> <p>hh:mm</p> </li> <li> <p>hh:mm:ss</p> </li> <li> <p>hh:mm AM/PM</p> </li> <li> <p>hh:mm:ss AM/PM</p> </li> </ul> |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| 12-31-2000 | <ul> <li> <p>Formato da data: Personalizado</p> </li> <li> <p>Padrão de data: DD/MM/AAAA</p> </li> </ul> | 31/12/2000 |
| 05/04/2017 | Formato de data: dia da semana, MMMM D, AAAA hh:mm:ss AM/PM | Quinta-feira, 4 de maio de 2017 12:00:00 |

## Truncar data

Remove parte de uma data. O carimbo de data/hora será definido como o primeiro ponto da unidade para a qual você está truncando.

### Propriedades

| Propriedade | Configuração |
| --- | --- |
| Colunas para processar | Selecione a coluna ou colunas às quais deseja aplicar a função.<br><br>Se quiser aplicá-la a mais de uma coluna, use a lista suspensa para selecionar quais colunas e clique em Aplicar. |
| Unidade de tempo | Selecione a parte da data após a qual o valor será truncado. Se você estiver truncando para Dia ou superior, o valor retornado será uma data; caso contrário, será um carimbo de data/hora.<br><br><ul> <li> <p>Ano</p> </li> <li> <p>Mês</p> </li> <li> <p>Dia</p> </li> <li> <p>Hora</p> </li> <li> <p>Minuto</p> </li> <li> <p>Segundo</p> </li> </ul> |
| Criar nova coluna | Marque essa caixa de seleção se quiser emitir o resultado dessa função em uma nova coluna e manter a original inalterada. |

### Exemplo

| Entrada | Configuração | Saída |
| --- | --- | --- |
| 2024-06-22 | Unidade de tempo: Ano | 2024-01-01 |
| 2024-06-22 11:05 | Unidade de tempo: Mês | 2024-06-01 |
| 2024-06-22 11:05:35 | Unidade de tempo: Segundo | 2024-06-22 11:05:01 |