Zum Inhalt

Datums- und Zeitgeneratoren

Anwendungsfälle für Datum und Uhrzeit

BirthdateGenerator

Erzeugt Geburtsdaten innerhalb einer konfigurierten Altersspanne.

Warum: Wenn das Alter zum Referenzdatum eingehalten werden muss; für altersunabhängige Daten DateTimeGenerator verwenden.

Kategorie: person.

Ergebnis: datetime.

1
<key name="value" generator="BirthdateGenerator(min_age=18, max_age=67)"/>

Parameter

  • min_age: int; Standardwert 1 — Inklusives Mindestalter, das das Geburtsdatum abbildet.
  • max_age: int; Standardwert 100 — Inklusives Höchstalter, das das Geburtsdatum abbildet.

DateTimeGenerator

Erzeugt feste, begrenzte, gewichtete, versetzte oder referenzrelative Zeitwerte.

Warum: Für deterministische Zeitregeln wie Zeitfenster, Geschäftszeiten, Offsets und Feldabhängigkeiten verwenden.

Kategorie: core.

Ergebnis: datetime | int.

1
<key name="value" generator="DateTimeGenerator(min='2026-01-01', max='2026-12-31', random=True, input_format='%Y-%m-%d')"/>

Parameter

  • min: str | null; Standardwert None — Inklusive untere Grenze des Wertebereichs.
  • max: str | null; Standardwert None — Inklusive obere Grenze des Wertebereichs.
  • value: str | null; Standardwert None — Fester Wert; nicht mit Zufalls- oder Offset-Modus kombinierbar.
  • random: bool | null; Standardwert False — Aktiviert die Zufallsauswahl im konfigurierten Fenster.
  • random_mode: bool | null; Standardwert None — Expliziter Alias für die Zufallsauswahl im Wertefenster.
  • input_format: str | null; Standardwert None — Python-Zeitformat zum Parsen von Grenzen und festen Werten.
  • hour_weights: list[float] | null; Standardwert None — 24 relative Gewichte für die Auswahl der Stunde.
  • minute_weights: list[float] | null; Standardwert None — 60 relative Gewichte für die Auswahl der Minute.
  • second_weights: list[float] | null; Standardwert None — 60 relative Gewichte für die Auswahl der Sekunde.
  • month_weights: list[float] | null; Standardwert None — 12 relative Gewichte für die Auswahl des Monats.
  • weekday_weights: list[float] | null; Standardwert None — Sieben relative Gewichte für Montag bis Sonntag.
  • dom_weights: list[float] | null; Standardwert None — Relative Gewichte für gültige Kalendertage eines Monats.
  • months: str | list[int] | null; Standardwert None — Erlaubte Monatsnummern, Bereiche oder Namen.
  • months_exclude: str | list[int] | null; Standardwert None — Monate, die aus dem erlaubten Fenster ausgeschlossen werden.
  • weekdays: str | list[int | str] | null; Standardwert None — Erlaubte Wochentagsnummern oder -namen.
  • dom: str | list[int | str] | null; Standardwert None — Erlaubte Kalendertage im Monat.
  • hours_preset: str | null; Standardwert None — Benanntes Stundenfenster, etwa Geschäftszeiten.
  • minute_granularity: int | null; Standardwert None — Positiver Minuten-Schritt zur Ausrichtung erzeugter Werte.
  • second_granularity: int | null; Standardwert None — Positiver Sekunden-Schritt zur Ausrichtung erzeugter Werte.
  • offset: str | null; Standardwert None — ISO-8601-Dauer oder arithmetischer Versatz zum Basiswert.
  • max_offset: str | null; Standardwert None — Maximaler Offset für einen begrenzten Zufallsversatz.
  • reference: str | null; Standardwert None — Feldreferenz, deren Zeitwert die Offset-Basis bildet.
  • as_epoch: bool; Standardwert False — Gibt statt eines Zeitwerts eine numerische Epoch-Darstellung zurück.
  • epoch_unit: str; Standardwert seconds — Genauigkeit der Epoch-Ausgabe in Sekunden oder Millisekunden.