Gere um pequeno lote de datas e transforme o resultado em casos de teste intencionais. Guarde início, fim, filtro, regra de unicidade e formato com o fixture; use YYYY-MM-DD para valores de máquina e acrescente casos separados para finais de mês e anos bissextos.
01 / OBJETIVO
O que um gerador de datas aleatórias para testes deve produzir
Um fixture útil é mais do que uma string com aparência de data. Ele tem um motivo: data de cadastro, janela de reserva, vencimento, filtro de relatório ou evento que precisa ser ordenado. O gerador cria variedade rapidamente, mas o desenho do teste decide o que essa variedade deve provar. Comece nomeando o campo e o comportamento a verificar.
Por exemplo, uma lista ordenada por created_at deve conter meses diferentes, não o mesmo dia de janeiro em todas as linhas. Um formulário de reserva precisa de datas antes, dentro e depois da janela permitida. Uma regra de idade deve ser testada no dia anterior ao aniversário, no dia exato e no dia seguinte. A seleção é a entrada; a asserção continua sendo sua responsabilidade.
- Nomeie o campo ou recurso que receberá a data.
- Defina o comportamento que precisa permanecer verdadeiro para cada valor.
- Decida quais datas devem ser adicionadas de propósito, em vez de deixadas ao acaso.
02 / MODELO DE DATA
Decida se o campo é data, hora ou timestamp
Antes de gerar, identifique o significado do campo. Uma data de calendário, como um vencimento, não tem fuso horário. Um campo como created_at tem hora e normalmente precisa de uma zona explícita. Um seletor de data e hora combina os dois e pode depender do horário de verão. Passar uma data pura pela meia-noite local pode mudar o dia quando outra zona a lê.
Para datas sem hora, prefira 2026-11-18 quando o valor será armazenado, ordenado, comparado ou enviado por API. Mantenha uma versão longa para capturas e revisão manual. Formatos numéricos dos EUA e da Europa ajudam a testar a apresentação, mas são ambíguos para parsers: 03/04 pode ser 4 de março ou 3 de abril. Teste a tela e o contrato do parser separadamente.
| Formato | Bom para | Ponto de revisão |
|---|---|---|
| YYYY-MM-DD | Campos de banco, APIs e fixtures | Sem ambiguidade e ordenável como texto se válido. |
| MM/DD/YYYY | Exibição para os EUA | Verifique um parser explicitamente norte-americano. |
| DD/MM/YYYY | Exibições regionais | Teste o locale em vez de adivinhar pela string. |
| Data longa | Capturas, e-mails e relatórios | Confira nomes de mês, acessibilidade e quebra de linha. |
| Data e hora | Logs, reservas e eventos | Adicione fuso e horário de verão à parte. |
03 / INTERVALO
Use limites inclusivos, não um período vago
Escreva dois limites concretos. From e To são inclusivos: um intervalo de um dia tem um valor possível e um ano inteiro inclui 1º de janeiro e 31 de dezembro. Essa regra é fácil de explicar no plano e de verificar com uma asserção. Se a aplicação exclui o limite superior, converta o fixture ou documente a diferença.
Um intervalo amplo mostra variação normal, mas não garante os limites. Encurte o intervalo em torno do fim de um mês, da mudança de ano ou de um limite de idade para tornar o resultado esperado claro. Use uma amostra para distribuição e um conjunto escolhido à mão para os extremos; um sorteio feliz não deve criar falsa confiança.
- Intervalo amplo: confira ordenação, agrupamento, paginação e distribuição.
- Intervalo curto: confira limites inclusivos e limite de quantidade.
- Intervalo de borda: confira finais de mês, anos bissextos e regras do negócio.
- Intervalo vazio: confira o erro quando o filtro deixa zero datas elegíveis.
04 / GERAÇÃO
Crie amostras realistas sem perder o controle
Comece com poucos valores. De cinco a vinte datas costumam bastar para inspecionar um fixture; um lote maior pode preencher uma tabela de staging ou testar paginação. Mantenha as datas únicas quando cada linha for um evento diferente. Permita repetições apenas ao testar importações duplicadas, vários registros no mesmo dia ou amostragem com reposição.
Aplique o filtro de dias antes de avaliar a saída. Segunda a sexta é uma regra de calendário, não um calendário de feriados. Uma segunda-feira pode ser feriado ou dia de fechamento. Se o produto precisa de dias úteis por país, gere dias comuns e depois acrescente um conjunto de feriados vindo da fonte do próprio produto.
- Gere primeiro um lote pequeno para inspeção.
- Use valores únicos para linhas distintas e repetições para testes de duplicidade.
- Use YYYY-MM-DD para máquinas e data longa para revisão humana.
- Copie intervalo e filtro junto da lista de resultados.
05 / CASOS DE BORDA
Adicione datas que a amostragem pode não encontrar
Amostras aleatórias mostram a variação comum, mas datas raras precisam ser adicionadas de forma explícita. Inclua 29 de fevereiro em um ano bissexto e os dias vizinhos. Acrescente o último dia de um mês de 30 e de um mês de 31 dias. Use 31 de dezembro e 1º de janeiro quando relatório ou assinatura atravessar o ano.
Para regras de idade ou elegibilidade, calcule o limite a partir do requisito e teste os dois lados. Quem completa 18 hoje é diferente de quem faz aniversário amanhã. Para vencimentos e renovações, teste a data exata, o instante anterior e o primeiro dia válido depois. O gerador fornece valores; o plano define a asserção.
- Ano bissexto: 29 de fevereiro e dias próximos.
- Finais de mês: fevereiro, abril, junho, setembro e um mês de 31 dias.
- Virada do ano: 31 de dezembro, 1º de janeiro e corte do relatório.
- Limites de regra: dia anterior, dia exato e dia posterior.
06 / REVISÃO
Deixe os dados explicáveis e repetíveis
Um fixture é mais fácil de manter quando o revisor responde quatro perguntas sem abrir o gerador: qual intervalo, quais datas eram elegíveis, podia haver repetição e qual formato foi copiado? Coloque as respostas no nome ou em uma pequena metadata. `orders_2026Q1_unique_iso` comunica mais que `random_dates_1`.
Compare a lista com a validação real da aplicação. Confirme que cada data é analisada, que strings inválidas são rejeitadas, que exibição e valor salvo coincidem e que a ordenação é cronológica, não alfabética por texto local. Algumas asserções na lista são melhores que afirmar que a amostra é aleatória.
- Mantenha intervalo, filtro, quantidade, unicidade e formato com o resultado.
- Teste validade, parsing, ordem, exibição e limites separadamente.
- Salve a saída que causou a falha para permitir a reprodução.
07 / LIMITES
O que datas geradas podem ou não provar
Uma data gerada mostra que o código aceita e processa o valor escolhido. Ela não prova que um horário está disponível, que um feriado vale em um país ou que um prazo legal foi interpretado corretamente. Essas afirmações exigem calendário do domínio, política ou fonte autorizada.
Mantenha o escopo honesto: planejamento, exemplos, fixtures de QA e amostragem comum. Para senhas, códigos, tokens, sorteios regulados ou decisões auditáveis, use uma fonte de aleatoriedade voltada à segurança.
CHECKLIST REPETÍVEL
Cinco passos do intervalo ao fixture
- Nomear o comportamentoEscreva o campo, regra ou fluxo que as datas irão exercitar.
- Escolher o modeloSepare data pura de data e hora e do comportamento de fuso.
- Definir o intervaloInforme From, To, quantidade e filtro de dias se necessário.
- Adicionar bordasInclua anos bissextos, finais de mês, virada de ano e limite do negócio.
- Guardar o contextoSalve intervalo, regras, formato e saída com erro no relatório.
PERGUNTAS FREQUENTES
FAQ sobre datas aleatórias para testes
Por que usar um gerador de datas aleatórias para testes?
Ele cria valores variados rapidamente para que formulários, relatórios, APIs e consultas não sejam testados sempre com a mesma data. Limites e asserções ainda são necessários.
Qual formato é melhor para fixtures?
Use YYYY-MM-DD para valores armazenados, ordenados, comparados ou enviados por API. Mantenha uma data longa para capturas e revisão manual.
As datas de teste devem ser únicas?
Use valores únicos quando cada linha for um evento diferente. Permita duplicatas para testar duplicidade, importações repetidas ou registros no mesmo dia.
O filtro de dias remove feriados?
Não. Ele classifica segunda a sexta e sábado ou domingo. Feriados, fechamentos e regras de país exigem outra fonte de calendário.
Como testar anos bissextos e finais de mês?
Adicione 29 de fevereiro, dias vizinhos, últimos dias de meses curtos e longos, 31 de dezembro e 1º de janeiro. Não dependa de um sorteio raro.
Posso usar datas geradas para segurança?
Não. Datas são previsíveis e este fluxo serve para amostras e QA. Use um gerador de segurança para senhas, tokens e credenciais.
Como outro tester pode repetir minha amostra?
Guarde intervalo, filtro, quantidade, unicidade, formato e saída com o caso. O fixture capturado fornece a reprodutibilidade.
Referências
Estas fontes de primeira mão apoiam os detalhes técnicos do guia. Uma data aleatória não é credencial de segurança nem registro legal.
- MDN: Crypto.getRandomValues()Contexto sobre valores aleatórios no navegador e suas limitações.
- MDN: input type=dateReferência para entradas de data nativas e seu formato.
- Visão geral de ISO 8601Por que a ordem ano-mês-dia facilita a troca de dados.
PRONTO PARA CRIAR UM FIXTURE
Comece com um intervalo claro
Gere algumas datas, deixe o formato explícito e use a lista acima para transformar uma amostra em um caso que possa ser revisado.