Data e Hora

Datas, horas e intervalos

Obter Data/Hora Atual

datetime.now

Retorna data e hora atuais

Como usar

Guarda a data e hora atuais (ou só a data) da máquina, para registrar horários, nomear arquivos ou calcular prazos.

Exemplo: Obtenha agora em {inicio} no começo do robô para medir o tempo de execução.

Campos

Campo	Tipo	Padrão	Detalhes
Obter	Opção	`Data e hora`	Opções: Data e hora, Só a data (00:00)
Salvar resultado na variável *	Variável de saída	`now`

Resultado: guardado na variável now (Data/hora).

Formatar Data/Hora

datetime.format

Formata data com padrão customizado

Como usar

Transforma uma data em texto num formato pronto (dd/mm/aaaa, ISO, por extenso, para nome de arquivo...) ou personalizado, como dd/MM/yyyy HH:mm.

Exemplo: Formate {now} como file_name para salvar relatorio_{data_texto}.xlsx.

Campos

Campo	Tipo	Padrão	Detalhes
Data *	Texto		Data vinda de outro comando, ou texto (09/10/2026, 2026-10-09, ISO) ou número de série do ExcelEx.: `{data} ou 09/10/2026 14:30`
Formato	Opção	`09/10/2026 (dd/mm/aaaa)`	Opções: 09/10/2026 (dd/mm/aaaa), 09/10/2026 14:30, 09/10/2026 14:30:05, 2026-10-09, 2026-10-09 14:30:05, 14:30, 09 de outubro de 2026, Dia da semana (sexta-feira), Para nome de arquivo (20261009_143005), Personalizado
Formato personalizado	Texto	`dd/MM/yyyy`	dd/MM/yyyy HH:mm:ss (MMMM = mês por extenso, dddd = dia da semana) ou o formato do Python %d/%m/%YSó quando «Formato» = «Personalizado»
Salvar resultado na variável *	Variável de saída	`date_text`

Resultado: guardado na variável date_text (Texto).

Analisar Data/Hora

datetime.parse

Parseia string de data

Como usar

Converte um texto em data, detectando o formato sozinho ou usando um formato informado. Necessário para comparar e calcular com datas lidas de telas e planilhas.

Exemplo: Converta "15/10/2026" lido do portal em {vencimento} com o formato br_date.

Campos

Campo	Tipo	Padrão	Detalhes
Texto *	Texto		Ex.: `09/10/2026 14:30`
Formato do texto	Opção	`Automático (dd/mm/aaaa, aaaa-mm-dd, ISO...)`	Opções: Automático (dd/mm/aaaa, aaaa-mm-dd, ISO...), 09/10/2026 (dd/mm/aaaa), 09/10/2026 14:30, 09/10/2026 14:30:05, 2026-10-09, 2026-10-09 14:30:05, 14:30, Para nome de arquivo (20261009_143005), Personalizado
Formato personalizado	Texto	`dd/MM/yyyy`	dd/MM/yyyy HH:mm:ss (MMMM = mês por extenso, dddd = dia da semana) ou o formato do Python %d/%m/%YSó quando «Formato do texto» = «Personalizado»
Salvar resultado na variável *	Variável de saída	`date`

Resultado: guardado na variável date (Data/hora).

Adicionar Tempo

datetime.add_time

Adiciona dias/horas/minutos

Como usar

Soma segundos, minutos, horas, dias, dias úteis, semanas, meses ou anos a uma data.

Exemplo: Some 5 dias úteis a {hoje} para calcular o prazo de entrega.

Campos

Campo	Tipo	Padrão	Detalhes
Data *	Texto		Data vinda de outro comando, ou texto (09/10/2026, 2026-10-09, ISO) ou número de série do ExcelEx.: `{data} ou 09/10/2026 14:30`
Quantidade a adicionar *	Número	`1`
Unidade	Opção	`Dias`	Opções: Segundos, Minutos, Horas, Dias, Dias úteis (seg–sex), Semanas, Meses, Anos
Salvar resultado na variável *	Variável de saída	`date`

Resultado: guardado na variável date (Data/hora).

Subtrair Tempo

datetime.subtract_time

Subtrai tempo

Como usar

Subtrai segundos, minutos, horas, dias, dias úteis, semanas, meses ou anos de uma data.

Exemplo: Subtraia 1 mês de {hoje} para buscar os pedidos do mês anterior.

Campos

Campo	Tipo	Padrão	Detalhes
Data *	Texto		Data vinda de outro comando, ou texto (09/10/2026, 2026-10-09, ISO) ou número de série do ExcelEx.: `{data} ou 09/10/2026 14:30`
Quantidade a subtrair *	Número	`1`
Unidade	Opção	`Dias`	Opções: Segundos, Minutos, Horas, Dias, Dias úteis (seg–sex), Semanas, Meses, Anos
Salvar resultado na variável *	Variável de saída	`date`

Resultado: guardado na variável date (Data/hora).

Diferença

datetime.difference

Calcula diferença entre datas

Como usar

Calcula a diferença entre duas datas na unidade escolhida (inclusive dias úteis).

Exemplo: Calcule os dias entre {vencimento} e {hoje} para saber os dias de atraso.

Campos

Campo	Tipo	Padrão	Detalhes
Data inicial *	Texto		Data vinda de outro comando, ou texto (09/10/2026, 2026-10-09, ISO) ou número de série do ExcelEx.: `{data} ou 09/10/2026 14:30`
Data final *	Texto		Data vinda de outro comando, ou texto (09/10/2026, 2026-10-09, ISO) ou número de série do ExcelEx.: `{data} ou 09/10/2026 14:30`
Resultado em	Opção	`Dias`	Opções: Segundos, Minutos, Horas, Dias, Dias úteis (seg–sex), Semanas, Meses, Anos
Salvar resultado na variável *	Variável de saída	`difference`

Resultado: guardado na variável difference (Número).

Comparar Datas

datetime.compare

Compara duas datas

Como usar

Compara duas datas (antes, depois, igual...) e guarda verdadeiro ou falso, podendo ignorar a hora.

Exemplo: Verifique se {vencimento} é antes de {hoje}, comparando só o dia, para cobrar os atrasados.

Campos

Campo	Tipo	Padrão	Detalhes
Data *	Texto		Data vinda de outro comando, ou texto (09/10/2026, 2026-10-09, ISO) ou número de série do ExcelEx.: `{data} ou 09/10/2026 14:30`
É	Opção	`Antes de`	Opções: Antes de, Antes ou igual a, Igual a, Diferente de, Depois de, Depois ou igual a
Outra data *	Texto		Data vinda de outro comando, ou texto (09/10/2026, 2026-10-09, ISO) ou número de série do ExcelEx.: `{data} ou 09/10/2026 14:30`
Comparar só o dia (ignorar a hora)	Sim/Não	`Não`
Salvar resultado na variável *	Variável de saída	`result`

Resultado: guardado na variável result (Booleano).