refactor(date)!: stricter error handling of between (#2719)

1 files changed, 3 insertions, 0 deletions

diff --git a/docs/guide/upgrading_v9/2711.md b/docs/guide/upgrading_v9/2711.md
new file mode 100644
index 00000000..ef9757d3
--- /dev/null
+++ b/docs/guide/upgrading_v9/2711.md
@@ -0,0 +1,3 @@
+### Require `from` and `to` in `faker.date.between()` and `betweens()`
+
+Previously, in `faker.date.between()` and `faker.date.betweens()` if the `from` or `to` parameter was omitted (in Javascript) or an invalid date (in Javascript or Typescript), they would default to the current date or reference date. Now, both boundaries must now be given explictly. If you still need the old behavior, you can pass `Date.now()` or the reference date for `from` or `to`.