Random date generator

Datas parecem simples até você tentar manipulá-las em código — aí o inferno começa. Os computadores modernos representam instantes de tempo internamente como um número inteiro: o timestamp Unix é a contagem de segundos desde 1 de janeiro de 1970 às 00:00:00 UTC, uma convenção estabelecida no Unix dos anos 1970. Antes da padronização, cada sistema operacional tinha seu próprio epoch: o COBOL usava datas de 6 dígitos (dd/mm/aa), o que virou a bomba-relógio do bug Y2K — quando o ano 2000 chegou, sistemas que guardavam o ano como dois dígitos não conseguiam distinguir 1900 de 2000. O custo estimado de correção foi de 300 a 600 bilhões de dólares globalmente. A ISO 8601, publicada em 1988, resolveu a ambiguidade com um formato canônico AAAA-MM-DD que tem a vantagem única de ser lexicograficamente ordenável — ordenar strings ISO 8601 por critério alfabético produz a ordem cronológica correta.

Por baixo do capô, trabalhar com datas envolve uma quantidade surpreendente de complexidade. O calendário Gregoriano, instituído pelo Papa Gregório XIII em outubro de 1582 para corrigir a deriva do calendário Juliano (que acumulara 10 dias de erro), não foi adotado ao mesmo tempo por todos os países — a Inglaterra adotou em 1752, a Rússia em 1918 após a Revolução, e alguns países só no século XX. Um ano bissexto acontece a cada 4 anos, exceto centenários não divisíveis por 400 (1900 não foi bissexto, 2000 foi). Fora isso, fuso horário e horário de verão são fontes inesgotáveis de bugs: se você converte uma data para UTC sem levar em conta o DST, pode acabar com uma diferença de uma hora que passa despercebida por meses até virar incidente em produção. A biblioteca moment.js foi baixada bilhões de vezes justamente para abstrair essa complexidade.

Para testes de software, ter um conjunto de datas distribuídas aleatoriamente num intervalo é indispensável. Filtros de data em dashboards, relatórios mensais, cenários de vencimento de contratos, timelines de eventos — todos precisam ser testados com dados realistas e variados, não só com a data de hoje e uma data fixa no passado. Um teste que só passa com `2024-01-01` e quebra com `2024-02-29` (dia 29 de fevereiro em ano bissexto) é um teste incompleto. Esta ferramenta gera datas dentro de um intervalo definido por você, com quantidade configurável, prontas para colar em fixtures de banco de dados, arquivos JSON de mock ou planilhas de QA.

Dates seem simple until you try to manipulate them in code — then things get interesting fast. Modern computers represent moments in time internally as an integer: the Unix timestamp is a count of seconds since January 1st, 1970, at 00:00:00 UTC, a convention established in the Unix systems of the 1970s. Before standardization, every OS had its own epoch: COBOL used 6-digit dates (dd/mm/yy), which became the ticking time bomb of the Y2K bug — when the year 2000 arrived, systems storing the year as two digits could not distinguish 1900 from 2000. The estimated cost of remediation was 300 to 600 billion dollars globally. ISO 8601, published in 1988, resolved the ambiguity with a canonical YYYY-MM-DD format that has the unique advantage of being lexicographically sortable — sorting ISO 8601 strings alphabetically produces the correct chronological order.

Under the hood, working with dates involves a surprising amount of complexity. The Gregorian calendar, instituted by Pope Gregory XIII in October 1582 to correct the drift of the Julian calendar (which had accumulated 10 days of error), was not adopted simultaneously by all countries — England adopted it in 1752, Russia in 1918 after the Revolution, and some countries only in the 20th century. A leap year occurs every 4 years, except for centennial years not divisible by 400 (1900 was not a leap year, 2000 was). Beyond that, timezones and daylight saving time are inexhaustible sources of bugs: if you convert a date to UTC without accounting for DST, you can end up with a one-hour discrepancy that goes unnoticed for months until it becomes a production incident. The moment.js library was downloaded billions of times precisely to abstract that complexity.

For software testing, having a set of dates randomly distributed within a range is indispensable. Date filters in dashboards, monthly reports, contract expiration scenarios, event timelines — all need to be tested with realistic and varied data, not just today's date and one fixed date in the past. A test that only passes with `2024-01-01` and breaks with `2024-02-29` (February 29th in a leap year) is an incomplete test. This tool generates dates within a range you define, with configurable quantity, ready to paste into database fixtures, JSON mock files, or QA spreadsheets.

Las fechas parecen simples hasta que intentas manipularlas en código — entonces empieza el caos. Los ordenadores modernos representan los instantes de tiempo internamente como un número entero: el timestamp Unix es la cuenta de segundos desde el 1 de enero de 1970 a las 00:00:00 UTC, una convención establecida en los sistemas Unix de los años 70. Antes de la estandarización, cada sistema operativo tenía su propio epoch: el COBOL usaba fechas de 6 dígitos (dd/mm/aa), lo que se convirtió en la bomba de tiempo del bug Y2K — cuando llegó el año 2000, los sistemas que guardaban el año con dos dígitos no podían distinguir 1900 de 2000. El coste estimado de la corrección fue de entre 300 y 600 mil millones de dólares a nivel mundial. La ISO 8601, publicada en 1988, resolvió la ambigüedad con un formato canónico AAAA-MM-DD que tiene la ventaja única de ser ordenable lexicográficamente — ordenar cadenas ISO 8601 alfabéticamente produce el orden cronológico correcto.

Bajo la superficie, trabajar con fechas implica una cantidad sorprendente de complejidad. El calendario gregoriano, instituido por el Papa Gregorio XIII en octubre de 1582 para corregir la deriva del calendario juliano (que había acumulado 10 días de error), no fue adoptado al mismo tiempo por todos los países — Inglaterra lo adoptó en 1752, Rusia en 1918 tras la Revolución, y algunos países solo en el siglo XX. Un año bisiesto ocurre cada 4 años, excepto los años centenarios no divisibles por 400 (1900 no fue bisiesto, 2000 sí lo fue). Además, los husos horarios y el horario de verano son fuentes inagotables de errores: si conviertes una fecha a UTC sin tener en cuenta el cambio de hora, puedes terminar con una diferencia de una hora que pasa desapercibida durante meses hasta convertirse en un incidente en producción. La librería moment.js fue descargada miles de millones de veces precisamente para abstraer esa complejidad.

Para las pruebas de software, disponer de un conjunto de fechas distribuidas aleatoriamente en un intervalo es indispensable. Los filtros de fecha en dashboards, los informes mensuales, los escenarios de vencimiento de contratos, las líneas de tiempo de eventos — todos necesitan ser probados con datos realistas y variados, no solo con la fecha de hoy y una fecha fija en el pasado. Una prueba que solo pasa con `2024-01-01` y falla con `2024-02-29` (el 29 de febrero en un año bisiesto) es una prueba incompleta. Esta herramienta genera fechas dentro de un intervalo que tú defines, con cantidad configurable, listas para pegar en fixtures de base de datos, archivos JSON de mock o hojas de cálculo de QA.