Skip to main content
A date and time data generator creates synthetic calendar values for tests, prototypes and fixture data. It returns ISO 8601 date-time strings, month names, weekday names and IANA time-zone identifiers, so development teams can test scheduling, filtering, expiry and localisation logic without using production records.
Generate sample dates at spotzee.com/tools/date-generator.

​
Why this matters

Hardcoded dates go stale. A fixture value that was safely in the future can become a past date and break renewal, expiry or scheduling tests. Date generator output can stay relative, seeded or bounded without hand-editing fixture files. Calendar logic also fails in quiet ways. Month labels overflow small UI cells. Date-only inputs get rejected by APIs that require a time-zone offset. And time-zone identifiers need to be valid IANA strings if they feed scheduling settings. Each Extended API call deducts a small per-call amount from your Spotzee credit balance. See the Spotzee pricing page for live per-tool pricing.

​
How it works

1

Send the request

POST to /generic/data/generate/date with count and a required method parameter. The count is a string from 1 to 100.
2

Choose a method

Use one of 11 methods: anytime, between, betweens, birthdate, future, past, recent, soon, month, weekday or timeZone.
3

Set scoped parameters

Send date boundaries, reference dates, age or year ranges, day or year windows, locale, abbreviation mode, context and seed values when the selected method uses them.
4

Read the response

Date methods return data.dates[]. Month, weekday and time-zone methods return data.values[], alongside generated, locale, method and optional seed.

​
Method reference

Boundary fields such as from, to and refDate must be ISO 8601 date-time strings with a time-zone offset. 2024-01-01T00:00:00.000Z is valid. 2024-01-01 is rejected.

​
What to watch for

  • Date-only boundary values. Use full ISO date-time strings with an offset for from, to and refDate.
  • Wrong method for the fixture. Use recent for activity fields, future or soon for due dates, birthdate for age paths and timeZone for scheduling preferences.
  • String output. month, weekday and timeZone return values[], not dates[].
  • Birthdate ranges. With mode=age, min and max are ages. With mode=year, they are years.
  • Large batches. One request generates 1 to 100 values. For more rows, call the endpoint again and vary the seed when you need a different batch.

​
FAQs

Generated date methods return ISO 8601 date-time strings in UTC. Boundary inputs also need a date, time and time-zone offset. Month, weekday and time-zone methods return strings instead.
The date generator supports 11 methods: anytime, between, betweens, birthdate, future, past, recent, soon, month, weekday and timeZone. Use the date methods for timestamps and the utility methods for calendar labels or IANA time-zone identifiers.
Yes. Use method=between or method=betweens with from and to values. Both values must include a date, time and time-zone offset.
Yes. Set a numeric seed to reproduce the same random date generator output for the same option set. Leave the seed blank when you want a fresh random batch.
Yes. It works as a test data generator for calendar UI because it returns timestamps, month names, weekday names and time-zone strings. Use locale and abbreviation controls to check translated labels and compact layouts.
Use this date generator guide for method details, then combine date data with the person generator guide, contact generator guide and name generator guide to build full test datasets.

​
Try it

Generate sample dates at spotzee.com/tools/date-generator. For batch or programmatic use, call the Extended API endpoint with your Spotzee API key.