Quantos dias um negócio fica parado em uma etapa, como inserir no contrato «15 de maio de 2026» em vez de uma data de máquina, quando é a sexta-feira mais próxima para um envio — no designer de processos de negócios do Bitrix24 não há ações prontas para isso. Quatro robôs da Roboteka cobrem as operações típicas com datas: diferença entre duas datas na unidade desejada, formatação para documentos e e-mails, busca da data mais próxima por condição e identificação do dia da semana.

Como calcular a diferença entre duas datas?

«Diferença entre duas datas». Entrada: data 1, data 2 e a unidade de medida — days, hours, minutes ou months, por padrão dias. Há três saídas: a diferença com sinal — negativa se a segunda data for anterior à primeira; a diferença em módulo; e a quantidade de dias completos, que é sempre retornada, independentemente da unidade escolhida. Exemplos: idade de uma fatura não paga em dias para escalonamento; horas da criação do lead até o primeiro contato para controle de SLA; meses desde a última compra para iniciar uma reativação. Os meses são contados pela grade do calendário — de 31 de janeiro a 1 de fevereiro é exatamente um mês, sem considerar o dia. O sinal da diferença é uma condição pronta «o prazo passou / ainda não» para a bifurcação: o número é gravado em uma variável e comparado com o limite.

Como exibir a data no formato «15 de maio de 2026»?

Nos campos do Bitrix24 a data é armazenada em formato de máquina, mas no contrato é preciso a data por extenso. O «Formatação de data» recebe a data e o formato: d.m.Y por padrão — 15.05.2026; D — «15 de maio de 2026»; Dlong — «15 de maio de 2026»; Mnom e Mgen — o nome do mês isolado no caso nominativo ou genitivo; também há suporte ao formato arbitrário do date() do PHP. Há uma única saída — a string formatada; ela é inserida no modelo de documento ou no texto do e-mail, onde a data de máquina pareceria estranha. Na entrada, o robô entende AAAA-MM-DD, DD.MM.AAAA, marca temporal (timestamp) e data com hora — ou seja, o valor de qualquer campo «data» pode ser passado sem preparo.

Como encontrar a sexta-feira mais próxima ou o dia 1?

O «Data mais próxima por condição» encontra, a partir da data de origem, a próxima data que se encaixa. Condições: dia da semana monday…sunday, first-day — o dia 1 do mês seguinte, last-day — o último dia do mês atual, next-weekday — o próximo dia útil. O indicador «incluir a própria data» (por padrão N) decide se a data de origem conta caso já se encaixe: «a próxima sexta-feira» a partir de uma sexta é ou hoje, ou daqui a uma semana. Saídas: a data nos formatos AAAA-MM-DD e DD.MM.AAAA e o número de dias até ela — por ele se pausa o processo até o momento desejado. Exemplos: resumo para o cliente às sextas, adiamento do pagamento para o dia 1, faturas no último dia do mês. Se a data recorrente também precisar ser um dia útil, complemente a combinação com uma verificação pelo calendário de produção.

Como ramificar o processo pelo dia da semana?

O «Dia da semana pela data» retorna o número do dia — 1 para segunda-feira, 7 para domingo —, o nome em russo e em inglês e o indicador de fim de semana Y/N, que considera apenas sábado e domingo, sem feriados nacionais. A combinação com o bloco «Condição» dá a lógica «de sexta»: se a solicitação foi criada na sexta à tarde — a tarefa é agendada para segunda, e não «daqui a um dia», caindo no sábado. O número do dia é cômodo para comparações «maior que 5 — fim de semana», e o nome em russo é inserido diretamente nas notificações — «ligamos de volta na quinta» — sem uma tabela manual de correspondência entre número e nome.

O que o robô faz com uma data fora do padrão?

Os quatro robôs aceitam a data nos formatos principais que os campos e variáveis do Bitrix24 entregam: AAAA-MM-DD, DD.MM.AAAA, DD/MM/AAAA, marca temporal e variantes com hora. Se não for possível interpretar o valor — o campo continha texto arbitrário ou estava vazio —, o robô retorna um resultado vazio ou zerado e grava o motivo no registro, sem parar o processo. Truque prático: depois do robô, coloque uma condição sobre o resultado vazio e um ramo com notificação ao responsável — assim o erro nos dados aparece de imediato, e não um mês depois em um relatório.

Conclusão

Diferença de datas — «Diferença entre duas datas»; formato em russo para documentos — «Formatação de data»; datas recorrentes — «Data mais próxima por condição»; lógica por dias — «Dia da semana pela data». Esses robôs estão na categoria gerais. Não há a operação para a sua tarefa — descreva-a, fazemos o robô de graça e o adicionamos ao catálogo.