Ferramenta Data e Hora

Versão:

2023.1

Last modified: January 23, 2023

Fluxo de trabalho de exemplo

A ferramenta Data e Hora tem um fluxo de trabalho de exemplo. Visite Exemplos de fluxos de trabalho para saber como acessar esse e muitos outros exemplos diretamente do Alteryx Designer.

Use a ferramenta Data e Hora para transformar dados de data/hora para uma variedade de formatos, incluindo formatos que podem ser usados em expressões ou que são mais fáceis de serem lidos. Você também pode especificar o idioma dos seus dados de data/hora.

O Designer não pode processar datas anteriores a 1º de janeiro de 1400.

Configurar a ferramenta

Conecte uma fonte de dados à âncora de entrada da ferramenta Data e Hora. Na janela Configuração, selecione o formato a ser convertido. Há duas opções:

Formato Date/Time para cadeia de caracteres: converte dados do tipo Date, Time ou DateTime em uma cadeia de caracteres (tipos String).
- Selecione o campo de data/hora a ser convertido: use o menu suspenso para escolher uma coluna de data/hora do tipo Date, Time ou DateTime. Se nenhuma coluna Date/Time estiver disponível, o menu aparece esmaecido e exibe a mensagem Nenhum campo de entrada adequado disponível.
- Especifique um nome para a nova coluna: insira um nome para os dados convertidos ou use o padrão DateTime_Out.
- Especifique o idioma de data/hora: use o menu suspenso para escolher o idioma de saída da nova coluna de cadeia de caracteres. Visite a seção Especifique o idioma de data/hora abaixo para obter uma lista de formatos por idioma.
- Selecione o formato da nova coluna: selecione na lista o formato para a nova coluna ou selecione Personalizado para criar um formato próprio usando a seção Especifique um formato personalizado para a nova coluna. Consulte a sessão Formato personalizado abaixo.
Cadeia de caracteres para formato Date/Time: converte dados de cadeia de caracteres (um dos tipos String) para o tipo Date, Time ou DateTime.
- Selecione o campo de cadeia de caracteres a ser convertido: use o menu suspenso para escolher uma coluna de cadeia de caracteres a ser convertida em um formato Date/Time. Se nenhuma coluna de cadeia de caracteres estiver disponível, o menu aparece esmaecido e exibe a mensagem Nenhum campo de entrada adequado disponível.
- Especifique um nome para a nova coluna: insira um nome para os dados convertidos ou use o padrão DateTime_Out.
- Especifique o idioma de data/hora: use o menu suspenso para identificar o idioma de entrada dos dados de cadeia de caracteres. Visite a seção Especifique o idioma de data/hora abaixo para obter uma lista de formatos por idioma.
- Selecione o formato que corresponde ao campo de cadeia de caracteres de entrada: selecione na lista o formato da cadeia de caracteres de entrada ou selecione Personalizado para determinar um formato diferente usando a seção Especifique o formato do campo de cadeia de caracteres de entrada. Consulte a sessão Formato personalizado abaixo.

Formato personalizado

Você pode especificar um formato personalizado que corresponda ao campo de caracteres de entrada ou ao novo campo de cadeia de caracteres sendo criado.

Selecione Personalizado para digitar um formato próprio. O Designer exibe um exemplo com base no formato que você insere.
Utilize os especificadores e separadores conforme mostrado abaixo (por exemplo, dd, MM, yyyy) ou os especificadores e separadores compatíveis com as funções de Data e Hora DateTimeParse e DateTimeFormat (por exemplo, %d, %m, %Y).

Você pode usar um asterisco (*) como curinga para substituir qualquer caractere no campo de formato de data.

Formatos de dia, mês e ano

d: dia do mês como dígitos, sem o zero à esquerda para dias de dígito único.
day: o nome completo do dia da semana.
dd: dia do mês com dois dígitos, com o zero à esquerda para dias de dígito único. Na entrada, o zero à esquerda é opcional.
dy: dia da semana abreviado com três letras. Na entrada, dias escritos por extenso são aceitos, mas o Alteryx não verifica se o dia da semana está de acordo com o resto da data.
EEEE: nome completo do dia da semana.
M: mês com um dígito, sem o zero à esquerda para meses de dígito único.
MM: mês como dígitos, com o zero à esquerda para meses de dígito único. Na entrada, o zero à esquerda é opcional.
MMM: nome do mês abreviado.
MMMM: nome completo do mês.
Mon: abreviação de três letras do nome do mês. Na entrada, nomes por extenso também são aceitos.
Month: nome completo do mês. Na entrada, abreviações também são aceitas.
yy: ano representado somente pelos dois últimos dígitos. Ao converter a partir de uma cadeia de caracteres, os anos de dois dígitos são mapeados para o intervalo entre o ano atual menos 66 anos até o ano atual mais 33 anos. Por exemplo, em 2016, um ano de dois dígitos será mapeado para o intervalo entre 1950 e 2049. Na entrada, anos com quatro dígitos também são aceitos.
yyyy: ano representado por quatro dígitos. Na entrada, anos com dois dígitos também são aceitos e mapeados do mesmo modo que o padrão "yy".

Especificadores para formatos de hora, minuto e segundo

ahh: AM/PM (somente chinês simplificado).
H: horas, sem o zero à esquerda nas horas de dígito único (sistema de 24 horas).
HH ou hh: horas, com o zero à esquerda nas horas de dígito único (sistema de 24 horas).
mm: minutos, com o zero à esquerda nos minutos de dígito único.
ss: segundos, com o zero à esquerda nos segundos de dígito único.

Separadores

Na saída, os separadores para o formato de data/hora são usados exatamente como o especificado. Na entrada...

- e / são aceitos como equivalentes.
Espaços em branco são ignorados.
: e , precisam corresponder de forma exata.

Especifique o idioma de data/hora

Formato Date/Time para cadeia de caracteres

Ao converter dados do tipo Date/Time para dados de cadeia de caracteres, use o menu suspenso Especifique o idioma de data/hora para escolher o idioma de saída da nova coluna de cadeia de caracteres. Dependendo do idioma, diferentes opções de formato estão disponíveis.

Cadeia de caracteres para formato Date/Time

Ao converter dados de cadeia de caracteres para o tipo Date/Time, use o menu suspenso Especifique o idioma de data/hora para identificar o idioma de entrada dos dados de cadeia de caracteres. Dependendo do idioma, diferentes opções de formato estão disponíveis.

Inglês