feat(date): add ability to provide date range for recent and soon

[ST-DDT]

Continuation of #3653 and #3783

• past/future date functions to support min years #3653
• feat(date): add ability to provide year range for past and future #3783

---

Extend date.recent and date.soons' days option to support ranges.

faker.date.recent({ days: { min: 4, max: 7 } }) // '2026-04-30T13:17:16.910Z'
faker.date.soon({ days: { min: 4, max: 7 } }) // '2026-05-11T01:14:05.068Z'

$ pnpm run docs:diff
Documentation changes detected:
- Date
  - recent
  - soon

Preview

• recent
• soon

[netlify]

✅ Deploy Preview for fakerjs ready!

Name	Link
🔨 Latest commit	65ed93f
🔍 Latest deploy log	https://app.netlify.com/projects/fakerjs/deploys/69fbb66b05388300086afe27
😎 Deploy Preview	https://deploy-preview-3844.fakerjs.dev
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[ST-DDT]

@xDivisionByZerox Sorry, I have seen to late, that you wanted to do this change yourself.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.91%. Comparing base (50a5ec9) to head (65ed93f).

Additional details and impacted files

@@           Coverage Diff           @@
##             next    #3844   +/-   ##
=======================================
  Coverage   98.91%   98.91%           
=======================================
  Files         901      901           
  Lines        3121     3139   +18     
  Branches      574      564   -10     
=======================================
+ Hits         3087     3105   +18     
  Misses         30       30           
  Partials        4        4           

Files with missing lines	Coverage Δ
src/modules/date/index.ts	100.00% <100.00%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[xDivisionByZerox]

@xDivisionByZerox Sorry, I have seen to late, that you wanted to do this change yourself.

All good @ST-DDT. I did not have that much time for OSS during the last weeks. Bringing the project forward is more important than satisfying someones ego ^^

[xDivisionByZerox]

Look good 👍