Package: randomtimestamp
randomtimestamp(v2.2)Random timestamp generatorInstallationYou know it:pip install randomtimestampUsagerandomtimestamp can be used from the command line or imported as a python module.Command line usageTo use the script from command line$ randomtimestamp
  30-08-1995 17:58:14Python Module UsageIn v2.2, the functionsrandomtimestamp,random_time, andrandom_dateare available.randomtimestamp()takes six optional arguments. A call without arguments returns a datetime betweenJanuary 1st, 1950, 00:00:00and({today}, 23:59:59).NOTE:start/endare resolved beforestart_year/end_year, thereforestart_year/end_yearhave no effect ifstart/endhave been provided.WARNING [breaking changes]: Order of arguments torandomtimestamphas been changed in v2.1. If you're passing parameters as positionals, be careful before upgrading. The function also returns adatetimeobject rather than a string.randomtimestamp(
    start_year: int = 1950,
    end_year: int = None,
    text: bool = False,
    start: datetime.datetime = None,
    end: datetime.datetime = None,
    pattern: str = "%d-%m-%Y %H:%M:%S"
    ) -> Union[datetime, str]:random_time()takes four optional arguments. A call without arguments returns a time betweenbetween (00:00:00)and(23:59:59).random_time(
    start: datetime.time = time.min,
    end: datetime.time = time.max,
    text: bool = False,
    pattern: str = "%H:%M:%S"
    ) -> Union[time, str]:random_date()takes four optional arguments. A call without arguments returns a date between(January 1, 1950)andtoday.random_date(
    start: datetime.date = date(1950, 1, 1),
    end: datetime.date = datetime.today().date(),
    text: bool = False,
    pattern: str = "%d-%m-%Y"
    ) -> Union[date, str]:In any of these function calls,start < end&start_year < end_yearis mandatory.patternhas no effect iftext = False.Changelog:v2.2Fixed microsecond handling bug in datetime range. Closesissue.v2.1Dropped a minor version identifier to account for the small size of module. Only 2 digits to be used hereafter.[Breaking change] Order of arguments to randomtimestamp() changed. Code using older versions without keyword arguments breaks.[Breaking change] By defaultrandomtimestamp()now generates datetime objects.text = Falseby default.Introducedrandom_time() & random_date()to generate only time or date if needed.v2.0.0Ability to providestart/endas datetime objects to randomtimestamp() for more precise control.Lower limit ofstart_year = 1950removed.Ability to use custom datetime pattern as described indatetime documentation.v1.0.0Randomtimestamp released. Timestamps can be generated between 1950 and current_year.The timestamp can be generated as a string (by default) or a datetime object.Examples:Here are some examples of the possible syntaxes:>>> from randomtimestamp import randomtimestamp, random_date, random_time

  >>> randomtimestamp()
  datetime.datetime(1970, 6, 2, 23, 34, 10)

  >>> randomtimestamp(start_year=2020, end_year=2021)
  datetime.datetime(2021, 1, 10, 5, 6, 19)

  >>> randomtimestamp(start_year=2020, end_year=2021, text=True)
  '05-09-2021 17:24:28'

  >>> random_time()
  datetime.time(13, 18, 14)

  >>> random_date()
  datetime.date(1990, 6, 13)
  
  >>> random_time(text=True, pattern='%I:%M:%S %p')
  '08:06:27 PM'In any case, if you ever feel stuck, usehelp(randomtimestamp)inside Python's REPL.Footnote:Type validation has been done, but it won't be required for most developers. If you're someone who likes to break the code with deliberately crafted inputs, you'd most likely receive aTypeErroror aValueError.However, if you do find a bug, please report to make the experience better for other developers.LicenseThis project is released underGNU GENERAL PUBLIC LICENSE V3.